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머리말 


위대한 령도자 김정일동지께서는 다음과 같이 지적하시였다. 

《프로그람을 개발하는데서 기본은 우리 식의 프로그람을 개발하는것입니다. 우리는 우 
리 식의 프로그람물 개발하는 방향으로 나가야 합니다.》(《김정일선집》제15권，196폐지) 

위대한 령도자 김정 일동지의 현명한 령도에 의하여 오늘 우리 나라에서는 프로그람기술 
이 빠른 속도로 발전하고있다. 

우리의 과학자，연구사들은 우리 식 조작체 계 《붉은별》을 개 발하였으며 각종 도구들과 
응용프로그람들을 개 발하기 위한 연구사업 을 활발히 진행 하고있다. 

우리는 정보공학을 전공하는 교원, 연구사들과 대학생들이 프로그람개발도구인 Qt 에 의 
하여 프로그람을 능숙하게 작성할수 있도록 하기 위하여 《Qt 일반지식》과 《Qt 프로그람개 발 
법》, 《Qt 프로그람개발도구》， 《Qt 실례프로그람》을 출판한다. 

《Qt 프로그람개 발법》에서는 Qt 에 의 한 GUI 프로그람작성 방법 을 서술한다. 

《Qt 일반지식》에서는 Qt 의 객체모형，신호와 처리부，사건과 사건려과기를 비롯한 Qt 
프로그람이 기초하고있는 일반적인 원리들을 서술한다. 

《Qt 프로그람개 발도구》에서는 Qt Designer 를 비롯한 어에 부속되 여 있는 각종 도구들 
의 사용법을 서술한다. 

《Qt 실례 프로그람》에서는 Qt 로 작성 한 실례 프로그람들을 서 술한다. 

Qt 도구묶음 (toolkit) 은 C++ 클라스서 고로서 여 러 가동환경 GUI 프로그람을 건설 하기 위한 
한조의 도구이 다. Qt 는 프로그람작성 자들이 하나의 원천나무를 리 용하여 응용프로그람들을 
Windows 95-XP, Mac OS X, Linux, Solaris, HP-UX, 그밖에 Xll 를 가지는 Unix 
의 다른 판들에서 실행하게 한다. 한가지 Qt 판본은 또한 같은 API 를 가지고 Embedded 
Linux 에서도 사용할수 있다. 

이 책 에서는 Qt 3에 의 한 GUI 프로그람작성 방법 에 대 하여 설명한다. 이 책 에서 는 사용 
자정의창문부품의 작성과 끌어 다놓기의 제공과 같은 고급한 수법들을 설명한다. 

독자들이 C++ 에 대 한 기 초지 식 을 리해 하고있는것 을 전제 로 한다. 코드실례 들은 C++ 의 
부분모임 을 사용하지 만 Qt 프로그람을 작성할 때 드문히 요구되 는 C++ 의 기 능들은 설 명하지 
않는다. 

이 책은 18개의 장으로 되였는데 간단한 대화칸만들기로부터 시작하여 입력과 출력，자 
료기 지작성，망프로그람작성 , XML, 다중스레 드실 현 방법 에 대 하여 구체 적 으로 서 술한다. 



제 1 장. 시작하기 


이 장에서는 표준 C++ 와 (가가 제공하는 기능을 결합하여 여러개의 자그마한 도형방식사 
용자대 면부 (GUI) 응용프로그람들을 만드는 방법 을 보여 준다. 또한 Qt 의 2가지 기 본개 념 인《신 
호와 처리부》그리고 배치에 대하여 소개한다. 

제 1절. Hello Qt 프로그람 

여기에 아주 간단한 Qt 프로그람이 있다. 

1 #include <qapplication.h> 

2 #include <qlabel.h> 

3 int main(int argc, char *argv[]) 

4 { 

5 QApplication app (argc, argv); 

6 QLabel *label = new QLabel("Hello Qt!", 0); 

7 app.setMainWidget(label); 

8 label->show(); 

9 return app.exec(); 

10} 

우선 프로그람을 한행씩 설명한 다음 프로그람을 콤파일하고 실행하는 방법 을 설명한다. 
1행과 2행은 QApplication 과 QLabel 클라스의 정의를 포함한다. 

5행 은 응용프로그람의 자원을 관리 하는 QApplication 객 체 를 생성 한다. Qt 가 자기 의 지 령 행 
인수를 가지므로 QApplication 구성자는 argc 와 argv 를 요구한다. 

6행 은 《Hello Qt!》 라고 현시 하는 QLabel 창문부품을 생 성한다. Qt 에서 창문부품 (widget) 은 사 
용자대면부의 시각적요소이다. 단추, 차림표, 흘림띠, 틀은 모두 창문부품의 실례들이다. 창문 
부품은 다른 창문부품들을 포함할수 있다. 례를 들면 응용프로그람창문은 보통 하나의 
QMenuBar, 하나의 QToolBar, 하나의 QStatusBar, 그밖에 다른 창문부품들을 포함하는 창문부 
품이다. 0인수 (null 지적자)의 QLabel 구성자는 창문부품이 독립적 인 창문이고 다른 창문안에 놓 
이 는 창문부품이 아니 라는것 을 의 미한다. 

7행은 표식자를 응용프로그람의 기본창문부품으로 만든다. 사용자가 기본창문부품을 닫으 
면(실례로 창문제목띠의 표를 찰칵하여) 프로그람은 완료된다. 사용자가 창문을 닫아서 기본창 
문부품이 없는 경우에도 프로그람은 배경에서 계속 실행될수 있다. 

8행은 표식자를 표시한다. 창문부품은 늘 은폐된 상태로 생성 되 므로 그것을 표시하기전에 
전 용화하여 깜빡거 림 을 피할수 있 다. 

9행은 응용프로그람의 조종을 Qt 에 넘긴다. 이 시점에서 프로그람은 일종의 대기 
(stand-by) 방식 에 들어 가며 마우스찰칵이나 건누르기와 같은 사용자의 작용 (action) 을 기다린다. 



사용자의 작용은 사건(통보문이라고도 한다.)을 발생시키며 보통 프로그람은 하나이상의 
함수들을 실행하여 사건에 응답할수 있다. 이 시점에서 GUI 응용프로그람은 관례적인 묶음 
( batch ) 프로그람과 전혀 다르다. 일반적으로 묶음프로그람은 입력을 처리하고 결과를 생성하며 
사람들과 교제없 이 완료한다. 


■ hello 


|Hello Qt! | 

그림 1-1. Windows 자에 서 Hello 프로그람 

그러 면 콤퓨터 에서 프로그람을 시 험해보자. 우선 Qt 를 설치 해 야 한다. 지 금까지 는 Qt 가 
정확히 설치되여있고 (가의 bin 등록부가 PATH 환경변수안에 있는것으로 가정하였다. (Windows 
에서는 이것이 Qt 설치프로그람에 의하여 자동적으로 수행되므로 걱정할 필요는 없다.) 

또한 hello 라는 등록부안의 hello.cpp 파일에 Hello 프로그람의 원천코드가 있어야 한다. 
hello.cpp 를 자체 로 입 력한다. 

지 령재촉문으로부터 등록부를 hello 로 변경한 다음 qmake -project 라고 입 력 하여 가동환경 
( platform ) 에 의존하지 않는 프로젝트파일 ( hello . pro ) 을 만들고 qmake hello.pro 라고 입력하여 프 
로젝트파일로부터 가동환경에 고유한 makefile 을 만든다. make 를 실행하여 프로그람을 건설하 
고 Windows 에서 는 hello , Unix 에서 는 ./ hello , Mac OS 표에서 는 open hello.app 라고 입 력하여 프로 
그람을 실행 한다. Visual C ++ 를 리 용한다면 make 대신에 nmake 를 실행하여 야 한다. 혹은 qmake 
-tp vc hello.pro 라고 입 력하여 hello.pro 로부터 Visual Studio 프로젝트파일을 생성하고 프로그람을 
Visual Studio 에 서 건 설 할수 있 다. 



그림 1-2. 기본 HTML 형식의 표식자 
간단한 HTML 형식을 사용하여 표식자를 밝게 할수 있다. 다음 행 
QLabel *label = new QLabel("Hello Qt !", 0); 


QLabel *label = new QLabel ( M < h 2>< i > Hello </ i > " "<font color = red > Qt !</ font ></ h 2> M , 0); 
로 변경하고 응용프로그람을 다시 건설한다. 

제2절. 련결의 만들기 

다음의 실례는 사용자의 작용에 응답하는 방법을 보여준다. 응용프로그람은 사용자가 마 
우스를 찰칵하면 중지되는 하나의 단추로 이루어진다. 원천코드는 Hello 와 거의 비숫하지만 
기본창문부품으로서 QLabel 대신에 QPushButton 을 사용하며 사용자의 작용(단추를 찰칵하여：)과 
코드의 한 부분을 련결한다. 




if Quit il 

그림 1-3. Quit 응용프로그람 

1 #include < qapplication . h > 

2 #include < qpushbutton . h > 

3 int main(int argc , char * argv []) 

4 { 

5 QApplication app ( argc , argv ); 

6 QPushButton ^button = new QPushButton ( M Quit ", 0); 

7 QObject :: connect ( button , SIGNAL ( clicked ()), 

8 & app ? SLOT ( quit ())); 

9 app . setMainWidget ( button ); 

10 button -> show (); 

11 return app . exec (); 

12 } 

어의 창문부품은 신호 ( signal ) 를 발생 ( emit ) 하여 사용자의 작용이 있거나 상태의 변화가 발 
생하였다는것을 알린다. (Qt 신호는 Unix 신호와 관계없다. 이 책에서는 Qt 신호에 대해서만 취급 
한다.) 실례로 QPushButton 은 사용자가 단추를 찰칵할 때 clickedO 신호를 발생한다. 신호를 처 
리부 ( slot ) 라고 부르는 하나의 함수와 련결하면 신호가 발생될 때 처리부가 자동적으로 실행된 
다. 실례에서는 단추의 clicked () 신호를 QApplication 객체의 quit () 처리부에 련결한다. SIGNAL () 
과 SLOT () 마크로는 문법 의 한 부분으로서 다음 장에 서 자세 히 설 명한다. 

그러 면 응용프로그람을 만들어 보자. quitcpp 가 들어있는 quit 라는 등록부를 만들었다고 가 
정 하자. quit 등록부에서 qmake 를 실행하여 프로젝트 파일을 생성 한 다음 qmake 를 다시 실행하 
여 makefile 을 생 성한다. 
qmake -project 
qmake quit.pro 

이제는 응용프로그람을 건설하고 실행한다. Quit 를 찰칵하거나 Space 건을 눌러서 프로그람 
을 완료한다. 

다음의 실례에서는 신호와 처리부를 사용하여 두개의 창문부품을 동기시키는 방법을 보 
여준다. 응용프로그람이 사용자의 나이를 물으면 사용자는 스핀칸이나 미끄럼칸 ( slider ) 을 조작 
하여 입력할수 있다. 
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그림 i _4. 나이입 력 응용프로그람 

응용프로그람은 3개의 창문부품 즉 하나의 QSpinBox , 하나의 QSlider 그리고 하나의 
QHBox (수평배치칸)로 이루어진다. QHBox 는 응용프로그람의 기본창문부품이다. QSpinBox 와 
QSlider 는 QHBox 안에 그려지며 QHBox 의 자식들이다. 



그림 1-5. 나이입 력 응용프로그람의 창문부품들 

1 #include < qapplication . h > 

2 #include < qhbox . h > 

3 #include < qslider . h > 

4 #include < qspinbox . h > 

5 int main(int argc , char * argv []) 

6 { 

7 QApplication app ( argc , argv ); 

8 QHBox *hbox = new QHBox ( O ); 

9 hbox -> setCaption( M Enter Your Age ’’); 

10 hbox -> setMargin (6); 

11 hbox -> setSpacing (6); 

12 QSpinBox *spinBox = new QSpinBox ( hbox ); 

13 QSlider * slider = new QSlider ( Qt : : Horizontal , hbox ); 

14 spinBox -> setRange (0, 130); 

15 slider -> setRange (0, 130); 

16 QObject : : connect ( spinBox , SIGNAL ( valueChanged ( int )), 

17 slider , SLOT ( setValue ( int ))); 

18 QObject : : connect ( slider , SIGNAL ( valueChanged ( int )), 

19 spinBox , SLOT ( setValue ( int ))); 

20 spinBox -> setValue (3 5); 

21 app . setMainWidget ( hbox ); 

22 hbox -> show (); 

23 return app . exec (); 

24} 

8 〜 11 행은 QHBox 를 설정한다. (QHBox 구성자에서 콤파일러오유가 발생하면 이것은 낡은 
판의 어를 사용하고있다는것을 의미한다. 이때 자기가 Qt 3.2.0 이나 그 이후의 Qt 3출하판을 







사용하고있는가 확인한다.) 창문의 제목띠 에 현시할 본문을 설정 하기 위 하여 setCaptionO 을 호 
출한다. 그때 자식창문부품들사이 에 약간한 공간 (6 화소)을 둔다. 

12행 과 13행 은 QHBox 를 부모로 하여 QSpinBox 와 QSlider 를 각각 하나씩 생 성한다. 

창문부품들의 위치나 크기를 명백히 설정하였어도 QSpinBox 와 QSlider 는 QHBox 안에 보 
기좋게 나란히 배치된다. 이것은 QHBox 가 자식들의 요구에 기초하여 자동적으로 합리적인 
위치와 크기를 그것들에 할당하기때문이다. Qt 는 QHBox 와 같은 클라스들을 수많이 제공하여 
프로그람작성자들이 화면위치와 관련한 어려운 코드를 작성하는 자질구레한 일에서 해방시켜 
준다. 

14행과 15행은 스핀칸과 미끄럼칸에 유효범위를 설정한다. (여기서는 130살미만이 라고 가 
정한다.：) 16〜19행 에 보여 주는 2개 의 connectO 호출은 스핀칸과 미 끄럼 칸이 늘 같은 값을 표시 
하도록 동기된다는것을 담보한다. 한 창문부품의 값이 변화될 때마다 valueChanged ( int ) 신호가 
발생되고 다른 창문부품의 setValue ( int ) 처리 부가 새 값으로 호출된 다. 

20행은 스핀칸의 값을 35로 설정한다. 이때 QSpinBox 는 int 값 35를 인수로 하여 
valueChanged ( int ) 신호를 발생 시 킨 다. 이 인 수는 QSlider 의 setValue ( int ) 처 리 부에 넘 어 가며 미 끄 
럼칸의 값을 35로 설정한다. 그때 미끄럼칸은 valueChanged ( int ) 신호를 발생시키며 그 자체의 
값이 변경 되였으므로 스핀 칸의 setValue ( int ) 처리 부를 실행 한다. 그러나 이 시점에서 
setValue ( int ) 는 스핀칸의 값이 이미 35이므로 신호를 발생시키지 않는다. 이것은 무한재귀를 
방지한다. 그림 1-6 은 이 려 한 상황을 요약한다. 

1 . . . 1111 

setValue(35) 

2. |35：| Hjlllllllllllll 

valueChanged(35) 

1 . 

setValue(35) 
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3. [ 트 { llll[|]lllllllll 

valueChanged(35) 

..J 

i 

setValue{35) 

4. 135:| 

그림 1-6. 한개 값의 변경 에 의한 두개 값의 변경 

22행 은 QHBox 와 그의 두 자식창문부품을 표시 한다. 

Qt 에서 사용자대면부를 건설하는 수법은 리해하기 쉽고 유연성이 아주 높다. Qt 프로그람 
작성자들이 사용하는 가장 일반적인 수법은 필요한 창문부품들의 실례를 만든 다음 요구될 
때 그 속성 들을 설 정하는것 이 다. 프로그람작성 자들은 창문부품들에 배 치관리 자를 추가하여 





크기와 위치를 자동적으로 조절한다. 여의 신호-처리부기구에 의하여 창문부품들을 서로 련결 
하여 사용자대면부의 동작을 관리한다. 


제3절. 참고문서의 사용 


Qt 의 참고문서는 Qt 개발자들에게 아주 중요한 문서이다. 여기서는 어의 클라스와 함수들 
을 모두 설 명한다. 災 t 3.2 에 는 400개 이 상의 공개 클라스와 6000개 이 상의 함수들이 포함되 여있 
다.) 이 책에서는 Q t 의 수많은 클라스와 함수들의 사용방법을 기본적으로 설명하지만 그것들 
을 모두 언급하지 않는다. 


장문부품의 형식 

지금까지 보아온 그림들은 Windows 자에서 취 한것 이지만 Qt 응용프로그람은 유지하고있 
는 모든 가동환경 에서 아주 자연스럽게 표시할수 있다. Qt 는 특정 한 가동환경 이 나 도구묶음 
의 창문부품일식을 포함하는것 이 아니 라 가동환경의 형식 ( style ) 을 모의함으로써 이 것을 달 
성 한다. 
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그림 1-7. 어디서나 사용할수 있는 형식들 

Qt 응용프로그람의 사용자들은 - style 지 령행선택을 사용하여 기 정형식을 무시할수 있다. 
례를 들면 Unix 에서 나이입 력응용프로그람을 Platinum 형식으로 기동하려면 지령행에서 간단 
히 다음과 같이 입력한다. 

./age - style=Platinum 



그림 1-8. 가동환경에 고유한 형식들 

다른 형 식 들과 달리 Windows XP 와 Mac 의 형식들은 가동환경의 주제 ( theme ) 엔진에 기 초 
하고있으므로 자기 본래의 가동환경에서만 사용할수 있다. 


참고문서는 Qt -2] doc \ htal 등록부에 HTML 형식으로 존재하며 웨브열람기에 의하여 읽을수 
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있 다. 또한 이의 방조 열 람기 인 Qt Assistant 를 사용할수 있 다 . Qt Assistant 는 웨 브열 람기 보다 더 
빠르고 편리 하며 강력 한 탐색기 능과 색 인기능을 갖추고있 다. Qt Assistant 를 호출하려 면 Wind 
ows 에서는 Start 차림표에서 Qt 3.3. x|Qt Assistant 를 찰칵하고 Unix 에서는 지령행에 assistant 라고 
입 력하며 Mac OS X Finder 에서 assistant 를 두번 찰칵한다. 



그림 1-9. Qt Assistant 에 펼쳐진 Qt 문서 

홈폐 지 의 《API Reference 》 의 항목들은 어의 클라스들을 항행 하는 여 러 가지 방법 을 제 공 
한다 . 《All Classes 》 폐지 에는 QtAPI 의 모든 클라스들을 보여 준다 . 《Main Classes 》 폐지 에는 가 
장 일반적으로 사용하는 Qt 클라스들만 보여준다. 련습삼아 이 장에서 사용한 클라스와 함수 
들을 찾아볼수 있다. 계 승되 는 함수들은 기 초클라스의 문서 에서 설 명한다. 례 를 들면 
QPushButton 에는 자체의 show () 함수가 없지만 그 선조인 QWidget 로부터 계승된다. 그림 1-10 
에는 지금까지 고찰해온 클라스들사이의 관계를 보여준다. 
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그림 1-10. 지금까지 고찰한 Qt 클라스들의 계승나무 


제 2 장. 대화칸의 만들기 

이 장에 서 는 Qt 에 의 하여 대 화칸 (dialog box ) 을 만드는 방법 을 설 명한다. 대 화칸은 사용자 
와 응용프로그람사이 에 서로 교제하는 수단이다. 

대화칸은 사용자에게 자기가 좋아하는 값들을 선택할 기회를 준다. 대부분의 GUI 응용프 
로그람들은 차림표띠와 도구띠를 가지는 하나의 기본창문과 기본창문을 보충하는 한 조의 대 
화칸으로 이루어진다. 또한 적당한 작용들을 수행함으로써 사용자의 선택에 직접 응답하는 
대 화칸프로그람들을 작성할수 있게 한다(례 를 들면 수산기 프로그람). 

우선 순수 코드를 쓰는 방법으로 첫 대화칸을 만들고 그 동작을 고찰하기로 한다. 그다음 
어의 시각적인 설계도구인 Qt Designer 에 의하여 대화칸을 건설하는 방법을 고찰한다. Qt 
Designer 를 사용하면 코드를 작성하는것보다 훨씬 더 빠르고 각이 한 설계들을 간단히 시험하 
고 변경할수 있다. 


제1절. QDialog 의 파생클라스 만들기 

처음의 실례는 완전히 C ++ 로 쓴 Find 대화칸이다. 대화칸을 클라스로서 실현함으로써 대 
화칸을 자체의 신호와 처리부를 가지는 독립적이고도 필요한 모든것을 다 갖춘 부분품으로 
만든다. 



그림 2 -L Linux ( KDE ) 에 서 Find 대 화칸 

원천코드는 두개 의 파일 즉 finddialog.h 와 finddialog.cpp 에 보관된다. fiiuidialog.h 부터 보자. 

1 #ifndef FINDDIALOG_H 

2 #defme FINDDIALOG_H 

3 #include < qdialog . h > 

4 class QCheckBox ; 

5 class QLabel ; 

6 class QLineEdit ; 

7 class QPushButton ; 

1 행과 2 행(그리고 27 행;)은 머리부파일이 여러번 포함되지 않도륵 한다. 

3행은 Qt 에서 대화칸의 기초클라스인 QDialog 의 정의를 포함한다. QDialog 는 QWidget 를 
계승한다. 
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4 〜 7 행은 대화칸을 실현하는데 사용하는 Qt 클라스들의 앞방향선언이다. 앞방향선언 
(forward declaration ) 은 클라스정 의 (보통 자체 의 머리 부파일에 배 치 된 다.)가 제 공하는 자세 한 내 
용을 모두 주지 않고도 클라스가 존재한다는것을 C ++ 를파일러에게 알려준다. 

그다음 FindDialog 를 QDialog 의 파생클라스로 정의 한다. 

8 class FindDialog : public QDialog 

9 { 

10 Q_OBJECT 

11 public : 

12 FindDialog(QWidget ^parent = 0, const char *name = 0); 

클라스정의의 선두에 있는 Q_OBJECT 마크로는 신호나 처리부들을 정의하는 모든 클라스 
들에서 반드시 필요하다. 

FindDialog 구성자는 Qt 창문부품클라스들의 전형이다. parent 파라메터는 부모창문부품을 지 
정하고 name 파라메터는 창문부품에 이름을 준다. 이름은 임의로 선택할수 있고 주로 오유수 
정과 시험에 쓰인다. 

13 signals : 

14 void findNext(const QString & str , bool caseSensitive ); 

15 void findPrev(const QString & str , bool caseSensitive ); 

Signals 부분에서는 사용자가 Find 단추를 찰칵할 때 대화칸이 발생하는 두개의 신호를 선언 
한다. Search backward 선 택 이 허 용되 면 대 화칸은 findPrevO 를 발생 하고 그렇 지 않으면 findNext () 
를 발생한다. 

signals 예약어는 사실 마크로이다. C ++ 앞처리기가 signals 를 표준 C ++ 로 변환한 다음 를파 
일러가 콤파일한다. 

16 private slots : 

17 void findClicked (); 

18 void enableFindButton(const QString & text ); 

19 private : 

20 QLabel * label ; 

21 QLineEdit * lineEdit ; 

22 QCheckBox * caseCheckBox ; 

23 QCheckBox * backwardCheckBox ; 

24 QPushButton * findButton ; 

25 QPushButton * closeButton ; 

26}; 

27 #endif 

클라스의 private 부분에서는 두개의 처리부를 선언한다. 처리부들을 실현하기 위해서는 대 




화칸의 자식창문부품들의 대 부분을 호출해 야 하므로 그것 들의 지 적 자들도 보관한다. slots 예 약 
어 는 signals 와 갈은 마크로로서 C ++ 콤파일 러 가 인식할수 있는 코드로 전개 된다. 

변수들이 모두 지적 자로 선 언되 였고 머 리 부파일 에 서 변수들을 사용하지 않으므로 콤파일 
러는 완전한 클라스정의를 요구하지 않으며 앞방향선 언이면 충분하다. 그대신에 관련한 머 리 
부파일들 (< qcheckbox . h >, < qlabel . h > 등)을 포함하였지만 될수록 앞방향선언을 사용하면 를파 
일속도가 좀 더 빨타진다. 

그러면 FindDialog 클라스의 실현을 포함하는 finddialog.cpp 를 고찰하자. 

1 #include < qcheckbox . h > 

2 #include < qlabel . h > 

3 #include < qlayout . h > 

4 #include < qlineedit . h > 

5 #include < qpushbutton . h > 

6 #include " finddialog . h " 

우선 finddialog.h 와 함께 사용하려는 모든 Qt 클라스들에 대한 머리부파일들을 포함한다. 
Qt 클라스들에 대한 대부분의 머리부파일은 소문자로 된 클라스이름과 上확장자를 가전다. 

7 FindDialog :: FindDialog(QWidget ^ parent , const char * name ) 

8 : QDialog ( parent , name ) 

9 { 

10 setCaption ( tr ( M Find M ))； 

11 label = new QLabel ( tr("Find & what : n ), this ); 

12 lineEdit = new QLineEdit ( this ); 

13 label -> setBuddy ( lineEdit ); 

14 caseCheckBox = new QCheckBox ( tr("Match & case "), this ); 

15 backwardCheckBox = new QCheckBox ( tr( n Search & backward "), this ); 

16 findButton = new QPushButton ( tr ( ,, & Find M ), this ); 

17 findButton -> setDefault ( true ); 

18 findButton -> setEnabled ( false ); 

19 closeButton = new QPushButton ( tr ( M Close M ), this ); 

8 행 에 서 는 parent 와 name 파라메 터를 기 초클라스구성 자에 넘긴 다. 

10행 에서 는 창문의 제목을 Find 로 설정한다. 문자렬주위 의 tr () 함수는 문자렬을 여 러 가지 
언어로 번역할수 있게 한다. tr () 함수는 Q_OBJECT 마크로를 포함하는 QObject 와 그 파생클라스 
에서 선언된다. 

다음으로 자식창문부품들을 만든다. &기 호를 사용하여 지 름건을 지 적 한다. 례 를 들면 16 
행은 사용자가 Alt+F 를 누를 때 동작하는 Find 단추를 만든다. 또한 &기호는 초점을 조종하는 
데 쓰인다. 11행에서는 지름건이 Alt+W 인 표식자 ( label ) 을 만들고 13행에서는 표식자의 짝패를 
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행 편집 기 (line editor ) 로 설정한다. 짝패 ( buddy ) 는 표식 자의 지 름건을 누를 때 초점 을 받아들이는 
창문부품이다. 그러므로 사용자가 Alt+W (표식자의 지름건)를 누를 때 초점은 행편집기(짝패) 
로 간다. 

17행 에서 는 setDefault (仕 ue ) 를 호출함으로써 Find 단추를 대화칸의 기 정 단추 (default button ) 로 
만든다. (Qt 는 모든 가동환경 에 대하여 TRUE 와 FALSE 를 제공하며 그것들을 표준 仕 ue 와 false 
의 동의 어로 사용한다. 그렇지만 true 와 false 를 유지하지 않는 낡은 콤파일러 를 사용하는 경우 
에 만 코드에 서 대 문자판을 사용할 필요가 있다.) 기 정단추는 사용자가 Enter 건을 누를 때 늘 
리우는 단추이다. 18행에서는 Find 단추를 비능동상태로 한다. 창문부품이 비능동으로 될 때 보 
통 회색으로 표시되고 사용자가 조작할수 없다. 

20 connect ( lineEdit , SIGNAL ( textChanged(const QString &)), 

21 this , SLOT ( enableFindButton(const QString &))); 

22 connect ( findButton , SIGNAL ( clicked ()), 

23 this , SLOT ( fmdClicked ())); 

24 connect ( closeButton , SIGNAL ( clicked ()), 

25 this , SLOT ( close ())); 

비공개처 리부 enableFindButton(const QString 公 0 은 행편집 기안의 본문이 달라질 때마다 호 
출된다. 비공개처리부 findClickedO 는 사용자가 Find 단추를 찰칵할 때 호출된다. 대화칸은 사 
용자가 Close 를 찰칵할 때 닫긴다. close () 처리 부는 QWidget 로부터 파생되고 그 기정 동작은 창 
문부품을 숨기 는것 이 다. enableFindButtonO 과 findClickedO 처 리 부의 코드는 후에 고찰한다. 

QObject 는 FindDialog 의 기초클라스이므로 connectO 호출앞에서 QObject :: 앞붙이 를 생 략할수 
있 다. 

26 QHBoxLayout *topLeftLayout = new QHBoxLayout ; 

27 topLeftLayout -> addWidget ( label ); 

28 topLeftLayout -> addWidget ( lineEdit ); 

29 QVBoxLayout *leftLayout = new QVBoxLayout ; 

3 0 leftLayout -> addLayout ( topLeftLayout ); 

31 leftLayout -> addWidget ( caseCheckBox ); 

32 leftLayout -> addWidget ( backwardCheckBox ); 

33 QVBoxLayout *rightLayout = new QVBoxLayout ; 

34 rightLayout -> addWidget ( findButton ); 

35 rightLayout -> addWidget ( closeButton ); 

36 rightLayout -> addStretch ( 1); 

37 QHBoxLayout *mainLayout = new QHBoxLayout ( this ); 

3 8 mainLayout -> setMargin ( 11); 

39 mainLayout -> setSpacing (6); 


16 



40 mainLayout -> addLayout ( leftLayout ); 


41 mainLayout -> addLayout ( rightLayout ); 


42} 

끝으로 배 치 관리 자에 의 하여 자식 창문부품들을 배 치 한다. 배치관리자 (layout manager ) 는 창 
문부품들의 크기와 위치를 관리하는 객체이다. Qt 는 3가지 배치관리자를 제공한다. 
QHBoxLayout 는 창문부품들을 수평으로 왼쪽에서 오른쪽으로(일부 문화어에서는 오른쪽에서 
왼쪽으로) 배치하고 QVBoxLayout 는 창문부품들을 수직으로 우에서 아래로 배치하며 
QGridLayout 는 창문부품들을 살창형 태 로 배 치 한다. 

배 치 관리 자는 창문부품들이나 다른 배 치 관리 자들을 포함한다. QHBoxLayout 와 
QVBoxLayout , QGridLayout 들을 여러가지 결합방식으로 배치 하여 아주 복잡한 대화칸을 만들 
수 있다. 

Find 대화칸에서는 그림 2-2 에 보여주는것처럼 2개의 QHBoxLayout 와 두개의 QVBoxLayout 
를 사용한다. 바깥쪽 배치 관리자가 기본배치 (main layout ) 이고 FindDialog 객체 ( this ) 를 그 부모로 
하여 구성되며 대화칸의 전체령역을 차지하고 있다. 다른 3개 배치관리자는 보조배치 
( sub - layout ) 이다. 그림 2-2 의 오른쪽아래에 있는 작은《용수철》은 수축자항목 (spacer item ) 이다. 
수축자는 Find 와 Close 단추들아래의 빈 공간을 모두 리용하며 이 단추들이 배치관리자의 웃부 
분을 차지하도록 한다. 

배치관리자클라스의 한가지 미묘한 점은 그것이 창문부품이 아니라는것이다. 그대신에 배 
치관리자클라스들은 QLayout 를 계승하고 QLayout 는 QObject 를 계승한다. 그림에서 창문부품 
들은 실선륜곽선으로 표시 하고 배 치관리 자들은 점 선의 륜관선들로 표시 하여 창문부품들과의 
차이 를 강조한다. 실 행 하는 응용프로그람에 서 는 배 치 관리 자가 표시 되 지 않는다. 


leltlayout 

topLettLayoul 



-righlayout 

-mainLayout 


배치관리자가 창문부품은 아니지만 부모와 자식들을 가질수 있다. 배치 에서 《부모》의 의 
미는 창문부품에서와 전혀 다트다. 배치관리자는 창문부품을 부모로 하여 구성되며 
( mainLayout 에서 처 럼) 배치 관리 자는 자동적 으로 그자체를 창문부품우에 설치한다. 배치 관리 자 
가 부모없 이 구성 될 때 ( topLeftLayout , leftLayout , rightLayout 에 서 처 럼) 그 배 치 관리 자는 
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addLayoutO 에 의해 다른 배 치 관리 자에 삽입 되 여 야 한다. 

(가의 부모-자식기구 ( parent-child mechanism ) 는 QWidget 와 QLayout 의 기초클라스인 QObject 
에서 실현된다. 어떤 부모를 가지는 하나의 객체(창문부품, 배치관리자 혹은 다른 종류)를 창 
조할 때 부모는 그 객체를 자식들의 목록에 추가한다. 부모를 삭제할 때 자식목록을 순환하 
면서 매개 자식을 삭제한다. 자식들도 역시 스스로 자기 자식들을 모두 삭제하며 이 과정은 
아무것도 남지 않을 때까지 재귀적으로 진행된다. 

부모-자식기구는 기 억관리를 훨씬 단순화하며 기 억기가 루실될 위 험을 줄인다. 명시적으 
로 삭제해 야 할 객체들은 new 에 의 해 생성 되 며 부모가 없는 객체들이다. 그리 고 부모를 삭제 
하기전에 자식객체를 삭제하면 어는 자동적으로 부모의 자식목록으로부터 그 객체를 삭제한 
다. 

창문부품에서 부모는 한가지 의미를 더 가진다. 자식창문부품들은 부모의 령 역안에 표시 
된다. 부모창문부품을 삭제할 때 자식 이 기 억기로부터 없어질뿐아니 라 화면에서도 없어진다. 

addLayoutO 에 의하여 어떤 배치관리자를 다른 배치관리자에 삽입하면 안쪽 배치관리자는 
자동적으로 바깥쪽 배치관리자의 자식으로 되여 기억관리를 단순화한다. 이와 대조되게 
addWidget () 에 의해 창문부품을 배 치 관리 자에 삽입할 때 그 창문부품은 부모를 변경 하지 않는 
다. 

그림 2-3 은 창문부품과 배치 관리자의 계승관계를 보여 준다. 계승관계는 FindDialog 구성자 
코드에서 new 나 addLayoutO 호출을 포함하는 행들을 고찰하여 쉽게 끌어낼수 있다. 중요하게 
알아두어 야 할것 은 배 치 관리 자가 그것 이 관리 하는 창문부품들의 부모가 아니 라는것 이 다. 

FindDialog 

— QLabel (label) 

—— QLineEdit (lineEdit) 

—— QCheckBox (caseCieckBox) 

一 QCheckBox (backwardCheckBox) 

— QPushBunon (findButton) 

—— QPushButton (closeBunon) 

— QHBoxLayout (mairLayout) 

— QVBoxLa/out (leftLayout) 

• 一 QHBoxLayout (topLeftLayout) 

— OVBoxLa/out (rightLayout) 

그림 2-3. Find 대 화칸의 부모-자식 관계 

배치관리자외에도 아는 배치관리자참문부품 (layout widget ) 즉 QHBox (제1장에서 사용)， 
QVBox 및 QGrid 를 제 공한다. 이 클라스들은 자식창문부품들에 대 하여 부모와 배 치 관리 자로 
서 모두 봉사한다. 배 치관리 자창문부품들은 자그마한 실 례 들에 서 배 치관리 자들보다 사용하기 
편리하지만 유연성이 적고 더 많은 자원을 요구한다. 

이로써 FindDialog 의 구성자에 대한 개괄을 끝낸다. 대화칸의 창문부품과 배치관리자들 


18 



을 만드는데 new 를 사용하므로 우리가 만든 매개 창문부품에 대하여 delete 를 호출하는 해체 
자를 써야 하는것처럼 보인다. 그러나 그럴 필요는 없다 Qt 는 자동적으로 부모가 해체될 때 
자식 객 체 들을 삭제 하며 new 에 의해 할당된 객 체 들은 모두 FindDialog 의 자식 들이 다. 

그러면 대화칸의 처리부에 대하여 고찰하자. 

43 void FindDialog : : findClicked () 

44 { 

45 QString text = lineEdit -> text (); 

46 bool caseSensitive = caseCheckBox -> isOn (); 

47 if ( backwardCheckBox -> isOn ()) 

48 emit findPrev ( text , caseSensitive ); 

49 else 

50 emit findNext ( text , caseSensitive ); 

51 } 

52 void FindDialog :: enableFindButton(const QString & text ) 

53 { 

54 findButton -> setEnabled (! text . isEmpty ()); 

55} 

findClicked () 처리 부는 사용자가 Find 단추를 찰칵할 때 호출된 다. 이때 Search backward 선택 
에 따라서 findPrev () 혹은 findNext () 신호를 발생 한다. emit 예약어 는 (가에 고유한것으로서 다른 
Qt 확장기능처럼 C ++ 앞처리기에 의해 표준 C ++ 로 변환된다. 

enableFindButton () 처 리 부는 사용자가 행 편집 기안의 본문을 변경할 때마다 호출된다. 이 처 
리부는 편집 기안에 본문이 있으면 단추를 허 용하고 그렇 지 않으면 금지 한다. 

이려한 2개의 처리부들로 대화칸을 완성한다. 이제는 main.cpp 파일을 창조하여 FindDialog 
창문부품을 시 험해 볼수 있 다. 

1 #include < qapplication . h > 

2 #include ’’finddialog 上’ , 

3 int main(int argc , char * argv []) 

4 { 

5 QApplication app ( argc , argv ); 

6 FindDialog * dialog = new FindDialog ; 

7 app . setMainWidget ( dialog ); 

8 dialog -> show (); 

9 return app . exec (); 

10 } 

보통 qmake 를 실행하여 프로그람을 를파일한다. FindDialog 클라스정의 에 0 _OBJECT 마크로 
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를 포함하므로 qmake 가 생성한 makefile 에는 (가의 메타객체를파일러 moc 를 실행하기 위한특 
수규칙들이 포함되 여있다. 

moc 가 정확히 작업하기 위해서는 머 리부파일에 클라스정의를 넣어서 실현파일로부터 분 
리해야 한다. moc 가 생성 한 코드에 는 이 머리 부파일을 포함하고 자체의 규칙을 추가한다. 

Q_OBJECT 마크로를 사용하는 클라스들에 대하여 moc 를 실행해야 한다. qmake 가 자동적으 
로 makefile 에 필요한 규칙들을 추가하므로 이것은 문제로 되지 않는다. 그러나 qmake 에 의해 
makefile 을 다시 생성하는것을 잊 어버리고 moc 를 실행하지 않으면 련결프로그람은 일부 함수 
들이 선언되였는데 실현되지 않았다고 오유를 통보한다. GCC 는 다음과 같이 경고를 내보낸 
다. 

finddialog . o (. text +0 x 28): undefined reference to TindDialog: : QPaintDevice virtual table * 

Visual C ++ 의 출력 은 다음과 같이 시 작한다. 

finddialog.obj : error LNK 2001: unresolved external symbol 

’’ public: 〜 virtual bool _thiscall FindDialog : : qt _ property ( int , int,class QVariant *)’’ 

이러한 통보가 발생하면 qmake 를 다시 실행하여 makefile 을 갱신한 다음 응용프로그람을 
다시 건설한다. 

그러면 프로그람을 실행하자. 지름건들인 Alt + W , Alt + C , Alt+B 그리고 Alt+F 가 제대로 동작 
하는가를 확인 한다. Tab 를 눌러 서 창문부품들을 순환해 본다. 기 정타브순서 는 창문부품들을 창 
조한 순서 이 다. pWidgetseffabOrderO 를 호출하여 이 순서 를 변경 할수 있 다. 

제3장에서는 실제의 응용프로그람에서 Find 대화칸을 리용하며 findPrevO 와 fmdNext () 신호 
들을 처리부들에 련결한다. 


제2절. 신호와 처리부 

신호와 처리부기구 (signal and slot mechanism ) 는 Qt 프로그람작성의 기초이다. 이것은 응용프 
로그람작성자가 서로 모르는 객체들을 모두 결합할수 있도록 한다. 이미 신호와 처리부를 서 
로 련결하고 자체의 신호와 처리부를 선언하며 자체의 처리부들을 실현하고 자체의 신호들을 
발생시키는 방법에 대하여 보았다. 여기서는 이것에 대하여 좀 더 구체적으로 고찰한다. 

처리부는 보통의 C ++ 성원함수와 거의 같다. 처리부는 가상함수일수 있고 재정의될수 있 
으며 public , protected 혹은 private 일수 있고 다른 C ++ 성원함수처럼 직접 호출될수도 있다. 차 
이 는 처 리 부가 신호에 련결될수 있고 그러한 경 우에 처 리 부는 신호가 발생될 때마다 자동적 
으로 호출된다는것이다. 

connect () 문은 다음과 같다. 

connect { sender , SlGNAL ( signal ) 9 receiver , SLOT ( slot )); 

여기서 와 receiver 는 QObject 의 지 적자들이고 s / gwa / 과 slot 는 파라메터이름이 없는 

함수기 호 ( signature ) 이 다. SIGNAL () 과 SLOT () 마크로는 인 수를 문자렬 로 변 환한다. 

지금까지 본 실례들에서는 항상 서로 다른 처리부들에 서로 다른 신호들을 련결하였다. 
또한 다음과 갈은 특성들이 있다. 
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• 하나의 신호를 여러개의 처리부에 련결할수 있다. 

connect ( slider , SIGNAL ( valueChanged ( int )), spinBox , SLOT ( setValue ( int ))); 

connect ( slider , SIGNAL ( valueChanged ( int )), this , SLOT ( updateStatusBarIndicator ( int ))); 

신호가 발생될 때 처리부들은 임의의 순서로 하나씩 호출된다. 

• 여러개의 신호를 같은 처리부에 련결할수 있다. 

connect ( lcd , SIGNAL ( overflow ()), this , SLOT ( handleMathError ())); 

connect ( calculator , SIGNAL ( divisionByZero ()), this , SLOT ( handleMathError ())); 

어느 한 신호가 발생될 때 그 처리부가 호출된다. 

• 하나의 신호를 다른 신호에 련결할수 있다. 

connect ( lineEdit , SIGNAL ( textChanged(const QString &)), this , 

SIGNAL ( updateRecord(const QString &))); 

첫째 신호가 발생될 때 둘째 신호도 역시 발생된다. 이것을 별도로 하여 신호-신호련결을 
신호-처리부련결과 구별할수 없다. 

• 련결을 삭제할수 있다. 

disconnect ( lcd , SIGNAL ( overflow ()), this , SLOT ( handleMathError ())); 

Qt 는 객체가 삭제될 때 그 객체를 포함하는 모든 련결을 자동적으로 삭제하므로 이것은 
드물게 요구된다. 

하나의 신호를 하나의 처리부나 다른 신호에 련결할 때 갈은 형의 파라메터들이 갈은 순 
서로 놓여야 한다. 

connect ( ftp , SIGNAL ( rawCommandReply ( int , const QString &)), this , 

SLOT ( processReply ( int , const QString &))); 

하나의 신호가 거기에 련결되는 처리부보다 더 많은 파라메터를 가지면 나머지 파라메터 
들은 단순히 무시된다. 

connect ( ftp , SIGNAL ( rawCommandReply ( int , const QString &)), this , 

SLOT ( checkErrorCode ( int ))); 

파라메터형들이 호환되지 않거나 신호나 처리부가 존재하지 않으면 Qt 는 실행시에 경고 
를 내 보낸다. 마찬가지 로 (가는 신호나 처 리 부기 호에 파라메 터이 름이 포함되 면 경 고를 내 보낸 
다. 

ota 메타객체체계 

Qt 의 주요한 성과의 하나는 임의의 부분품을 그것이 련결된 다른 부분품들에 대하여 전 
혀 모르고도 서로 결합할수 있는 독립적인 쏘프트웨어부분품들을 창조하는 기구에 의하여 
C ++ 를 확장한것이다. 

그러한 기구를 메타객체체계 ( meta-object system ) 라고 부르며 두가지 주요한 기능 즉 신호 
및 처리 부와 자체 검토 ( introspection ) 를 제공한다. 자체 검토기능은 신호와 처리 부를 실현 하는 
데 필요되며 응용프로그람작성자들이 객체와 그 클라스이름에 의해 유지되는 신호와 처리 
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부의 목록을 비 롯하여 QObject 파생 클라스들에 대 한《메 타정 보》를 실 행 시 에 얻 을수 있게 한 
다. 또한 이 기 구는 Qt Designer 용의 속성 ( property ) 과 국제 화용본문번 역 (text translation ) 을 유지 
한다. 

표준 C ++ 는 (가의 메타객체체계가 요구하는 동적메타정보에 대한 지원을 제공하지 않는 
다. Qt 는 이 문제를 해결하기 위하여 moc 라는 도구를 따로 제공한다. moc 는 Q_OBJECT 클라 
스정의들을 문법적으로 해석하고 그 정보를 C ++ 함수들에서 사용할수 있게 만든다. moc 가 
순수 C ++ 에 의해 그 기능을 모두 실현하므로 (건의 메타객체체계는 임의의 C ++ 를파일러에 
서도 작업한다. 

이 기 구는 다음과 같이 작업한다. 

• Q_OBJECT 마크로는 QObject 의 매개 파생 클라스에서 실현되 여 야 하는 자체 검토함수들 
즉 metaObject () 와 className (), tr () 등을 선 언 한다. 

• (가의 moc 도구는 Q_OBJECT 에 의 해 선 언된 함수들과 신호들의 실현을 생성한다. 

• connect (), disconnectO 와 같은 QObject 성원함수들은 작업 할 때 자체검토함수들을 리 용 

한다. 

이러한 모든것들은 qmake 와 moc , QObject 에 의하여 자동적으로 조종되므로 그것을 고찰 
할 필요가 있다. 그러나 호기심이 있다면 moc 가 생성한 C ++ 원천파일들을 보고 그 실현이 

어떻게 작업하는가를 알수 있다. _ 

지금까지는 창문부품과 함께 신호와 처리부만 리용하였다. 그러나 기구자체는 QObject 에 
서 실현되며 GUI 프로그람작성으로 제한되지 않는다. 이 기구는 임의의 QObject 파생클라스들 
이 사용할수 있다. 

class Employee : public QObject 

{ 

Q_OBJECT 
public : 

Employee () { mySalary = 0;} 



public slots : 

void setSalary(int newSalary ); 




if (newSalary != my Salary ) { 
my Salary = newSalary ; 
emit salaryChanged ( mySalary ); 



setSalaryO 처 리 부를 실 현 하는 방법 을 기 억 하자. newSalary != mySalary 이 면 오직 
salaryChangedO 신호만 발생한다. 이것은 주기적인 련결에 의해 무한순환이 일어나지 않도륵 
한다. 


제3절. 대화칸의 고속설계 

Qt 는 재미있고 직관적으로 코드를 쓸수 있게 설계되였으며 순수 C ++ 원천코드를 쓰는 방 
법으로 Qt 응용프로그람들을 개발할수 있다. Qt Designer 는 프로그람작성자들에게 유효한 선택 
들을 제공하며 시각적으로 설계한 폼을 원천코드와 결합할수 있게 한다. 

이 절에서 는 Qt Designer 에 의 하여 그림 2-4 에 보여 주는 Go - to-Cell 대 화칸을 창조한다. 이 것 
을 코드로서 수행하든 Qt Designer 에서 수행하든 대 화칸의 창조는 항상 아래와 같은 기 본단계 
를 가지게 된다. 

• 자식창문부품들을 창조하고 초기 화한다. 

■ 자식창문부품들을 배 치 관리 자안에 놓는다. 

• 타브순서 를 설 정한다. 

- 신호-처 리 부련 결 들을 확립한다. 

• 대화칸의 사용자정의처리부들을 실현한다. 

Qt Designer 를 기동하려면 Windows 에서는 Start 차림표에서 Qt 3.3. x|Qt Designer 를 찰칵하고 
Unix 에 서 는 지 령 행 에 서 designer 라고 입 력 하고 Mac OS X Finder 에 서 는 designer 를 두번 찰칵한 
다. Qt Designer 가 기동할 때 형판들의 목록이 펼쳐진다. Dialog 형판을 선택한 다음 OK 를 찰칵 
한다. 그러면 Forml 창문이 나타난다. 



그림 2-4. Go - to-Cell 대 화칸 
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그림 2-5. 빈 폼을 가지는 Qt Designer 

첫 단계 에서는 자식창문부품들을 창조하여 폼우에 배치한다. 본문표식자 (text label ) 하나, 
행편집기 (line editor ) 하나，(수평)수축자 ( spacer ) 하나 그러고 두개의 누름단추 ( pushbutton ) 들을 
창조한다. 매 개 항목에 대 하여 Qt Designer 의 기 본창문의 왼쪽에 있는 toolbox 안의 이 름이 나 그 
림기호를 찰칵하고 그 항목을 배치하려는 품의 위치를 찰칵한다. 그리고 항목의 길이가 더 
짧아질 때까지 폼의 바닥을 끌고간다. 이리하여 그림 2-6 과 비숫한 폼을 만들어낸다. 폼우에 
서 항목들의 위치를 지 정하는데 너무 시간을 소비할 필요는 없다. 후에 Qt 의 배치관리자들이 
그것 들을 정 확히 배 치한다. 



그림 2-6. 창문부품들을 가지는 폼 

수축자항목은 Qt Designer 에 푸른색 용수철로 표시된다. 수축자는 최종폼에 보이지 않는 
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다. 


Qt Designer 의 기 본창문 오른쪽에 있는 속성편집 기 에 의 하여 각 창문부품의 속성 들을 설 
정 한다. 

① 본문표식 자를 찰칵하고 name 속성 을 label 로, text 속성 을 ”&Cell Location:” 로 설 정 한다. 

② 행 편 집 기 를 찰칵하고 name 속성 을 lineEdit 로 설 정 한다. 

③ 수축자를 찰칵하고 수축자의 orientation 속성이 Horizontal 로 설정되였는가를 확인한다. 

④ 첫째 단추를 찰칵하고 name 속성을 okButton 으로, enabled 속성을 False 로， default 속성을 
True 로, text 속성 을 OK 로 설 정 한다. 

⑤ 둘째 단추를 찰칵하고 name 속성 을 cancelButton 으로, text 속성 을 Cancel 로 설 정 한다. 

⑥ 폼의 배경을 찰칵하여 폼자체를 선택하고 name 속성을 GoToCellDialog 로, caption 속성을 
"Go to Cell" 로 설 정한다. 

"&Cell Location” 을 표시 하는 본문표식자를 제외 한 모든 창문부품들이 잘 보인다. Tools|Set 
Buddy 를 찰칵한다. 표식자를 누른 상태에서 마우스를 행편집기까지 끌고가서 놓는다. 그려면 
행편집기는 표식자의 짝패로 된다. 표식자의 buddy 속성이 lineEdit 로 설정되였는가를 검사하여 
이것을 확인할수 있다. 



그림 2-7. 속성모임을 가지는 폼 
다음 단계 에서는 폼우에 있는 창문부품들을 배치한다. 

① Cell Location 표식자를 찰칵하고 Shift 를 누른 상태에서 표식자옆에 있는 행편집기를 찰 
칵하여 그것 들을 둘다 선 택 한다. Layout | Lay Out Horizontally 를 찰칵한다. 

② 수축자를 찰칵한 다음 Shift 를 누르면서 폼의 OK 와 Cancel 단추들을 찰칵한다. Layout| 
Lay Out Horizontally 를 찰칵한다. 

③ 폼의 배경을 찰칵하여 항목들의 선택을 해제한 다음 Layout|Lay Out Vertically 을 찰칵한 
다. 

④ Layout|Adjust Size 를 찰칵하여 폼의 크기 를 최 량크기 로 조절 한다. 

폼우에 나타나는 붉은선들은 창조된 배치관리자들을 보여준다. 배치관리자들은 폼이 실행 
될 때 절대로 나타나지 않는다. 
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그림 2-8. 배치관러자들을 가지는 폼 

이 제 ToolslTab Order 를 찰칵한다. 초점 을 받아들이 는 매 개 창문부품옆 에 있는 푸른색 원 안 
에 수자가 나타난다. 초점을 받아들이려는 순서로 매개 창문부품을 찰칵한 다음 Esc 를 누른 
다. 



그림 2-9. 폼의 타브순서 설정 

이렇게 하면 폼설계는 끝난다. 신호-처리부련결들을 설정하고 사용자정의처리부들을 실현 
하여 폼이 동작하게 하는 부분만이 남는다. Edit | Connections 를 찰칵하여 련결편집 기를 펼친다. 



그림 2-10. Qt Designer 의 련 결(련 결 들을 만든후) 
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3 개의 련결을 만든다. 련결을 창조하려면 New 를 찰칵하고 내리펼침복합칸들을 리용하여 
Sender 와 Signal , Receiver , Slot 마당들을 설 정 한다. 

okButton 의 clicked () 신호를 GoToCellDialog 의 accept () 처리부에 련결한다. cancelButton 의 clic 
ked () 신호를 GoToCellDialog 의 reject () 처 리부에 련결한다. Edit Slots 를 찰칵하여 Qt Designer 의 
처리부편집기(그림 2-11) 를 펼치고 enableOkButton () 비공개처 리부를 창조한다. 끝으로 lineEdit 의 
textChanged(const QString &) 신호를 GoToCellDialog 의 새로운 enableOkButton () 처리부에 련결한 
다. 

대 화칸을 미 리 보려 면 Preview|Preview Form 차림 표선 택 을 찰칵한다. Tab 를 반복하여 눌러 서 
타브순서를 검사한다. Alt+C 를 늘러서 초점을 행편집기로 옮긴다. Cancel 을 찰칵하여 대화칸을 
닫는다. 

대화칸을 gotocell 이라는 등록부에 gotocelldialog.ui 로서 보관하고 일반본문편집기에 의하여 
같은 등록부에 main.cpp 파일을 창조한다. 



그림 2-11. Qt Designer 의 처 리 부편집 기 

#include < qapplication . h > 

#include " gotocelldialog . h " 
int main(int argc , char * argv []) 

{ 

QApplication app ( argc , argv ); 
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GoToCellDialog * dialog = new GoToCellDialog ; 

app . setMainWidget ( dialog ); 

dialog -> show (); 

return app . exec (); 

} 

이제 qmake 를 실행하여 . pro 파일과 makefile 을 창조한다. ( qmake - project ; qmake gotocell . pro ). 
qmake 도구는 사용자대면부파일 gotocelldialog . ui 를 탐색하여 적당한 makefile 규칙들을 생성하고 
gotocelldialog 上와 gotocelldialog . cpp 를 창조하는 고급한 도구이다. . ui 파일은 Qt 의 사용자대면부 
를파일 러 uic 에 의해 C ++ 로 변 환된 다. 

Qt Designer 리용의 한가지 우점은 원천코드를 혼돈시키지 않고 프로그람작성자들이 폼설 
계를 수정할 자유를 얻는다는데 있다. C ++ 코드를 쓰는 방법 으로 순수 폼을 개 발할 때 설계 에 
대한 변경은 시간을 소비하게 한다. Qt Designer 를 리용할 때 uic 는 변경된 폼들에 대해서만 원 
천코드를 재생하므로 시간을 량비하지 않는다. 

이제 프로그람을 실행하면 대화칸은 동작하지만 요구대로 정확히 기능하지 않는다. 

•0 K 단추는 항상 비능동상태로 된다. 

• 행편집기는 유효세포위치들만 받아들일 대신에 임의의 본문이나 다 받아들인다. 

그러 므로 이 문제 를 해 결 하기 위한 코드를 써 야 한다. 

폼의 배경을 두번 련속 찰칵하여 Qt Designer 의 코드편집 기를 펼친다. 편집기창문에서 다 
음의 코드를 입력한다. 

#include < qvalidator . h > 
void GoToCellDialog :: init () 

{ 

QRegExp regExp ("[ A - Za - z ] [1-9] [0-9] {0，2}"); 
lineEdit -> setValidator(new QRegExpValidator ( regExp , this )); 

} 

void GoToCellDialog :: enableOkButton () 

{ 

okButton -> setEnabled ( lineEdit -> hasAcceptableInput ()); 

} 

init () 함수가 폼구성자 ( uic 가 생성)의 끝에서 자동적으로 호출된다. 입력범위를 제한하기 위 
하여 유효기 를 설 정한다. Qt 는 3개 의 기 본유효성 확인클라스 즉 QIntValidator 와 
QDoubleValidator , QRegExpValidator 를 제공한다. 여기서는 정규식 ”[ A - Za - z ][ l -9][0-9]{0,2}" 을 가 
지고 QRegExpValidator 를 리용한다. 이것은 하나의 영문자와 그뒤에 1 〜999까지의 수값으로 
이루어진 값만이 유효하다는것을 의미한다.(정규식에 대해서는 QRegExp 클라스방조를 참고.) 
이것을 QRegExpValidator 구성자에 넘김으로써 GoToCellDialog 객체의 자식으로 만든다. 그 
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리하여 후에 QRegExpValidator 의 부모가 삭제될 때 자동적으로 삭제된다. 

enableOkButton () 처리부는 행편집기가 유효세포위치를 포함하는가에 따라서 (光:단추를 허 
용 혹은 금지 한다. QLineEdit :: hasAcceptableInput () 는 init () 함수에서 설정 한 유효기 를 사용한다. 



그림 2-12. Qt Designer 의 코드편 집 기 


코드를 입력한 후에 다시 대화칸을 보관한다. 이때 2개 파일 즉 사용자대면부파일 
gotocelldialog . ui 와 C ++ 원천파일 gotocelldialog . ui . h 를 보관한다. 다시 응용프로그람을 구축하고 
실행한다. 행편집기에 ’’ A 12’’ 라고 입력하면 OK 단추가 능동상태로 되는것을 알수 있다. 임의의 
본문을 입 력 하여 유효기 의 동작을 고찰한다. Cancel 을 찰칵하여 대 화칸을 닫는다. 

이 실례에서는 Qt Designer 에서 대화칸을 편집하고 Qt Designer 의 코드편집기에 의하여 코 
드를 추가하였다. 대화칸의 사용자대면부는 .ui 파일 (XML 기초파일형식)에 보관되고 코드 
는 . ui . h 파일 ( C ++ 원천파일)에 보관된다. 

. ui . h 의 다른 수법은 보통과 같이 Qt Designer 로 . ui 파일들을 창조하고 uic 가 생성한 클라스 
를 계 승하는 파생 클라스를 창조하고 거 기 에 나머 지 기 능을 추가하는것 이 다. 례 를 들면 
Go - to - Cell 대화칸에서 이것은 GoToCellDialog 를 계승하는 GoToCellDialoglmpl 클라스를 창조하여 
필요한 기능을 추가적으로 실현한다는것을 의미한다. 이 수법으로 . ui . h 코드를 변환하는것은 
간단하다. 결과는 다음의 머 리부파일과 갈다. 

#ifndef GOTOCELLDIALOGIMPL H 
#define GOTOCELLDIALOGIMPL H 
#include " gotocelldialog . h " 

class GoToCellDialoglmpl : public GoToCellDialog 

{ 

Q_OBJECT 

public : 

GoToCellDialogImpl(QWidget ^parent = 0, const char *name = 0); 
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private slots : 

void enableOkButton (); 

}； 

#endif 

그리고 원천파일은 다음과 같다. 

#include < qlineedit . h > 

#include < qpushbutton . h > 

#include < qvalidator . h > 

#include ’’ gotocelldialogimpl . h ” 

GoToCellDialoglmpl :: GoToCellDialogImpl(QWidget ^ parent , const char * name ) 

: GoToCellDialog ( parent , name ) 

{ 

QRegExp regExp ( M [ A - Za - z ][ l -9][0-9]{0,2}"); 
lineEdit -> setValidator(new QRegExpValidator ( regExp , this )); 

} 

void GoToCellDialoglmpl : : enableOkButton () 

{ 

okButton -> setEnabled ( lineEdit -> hasAcceptableInput ()); 

} 

파생클라스작성수법을 좋아하는 개발자들은 기초클라스 GoToCellDialogBase 과 그의 모든 
기능을 포함하면서 좋은 이름을 가지는 파생클라스 GoToCellDialog 를 호줄한다. 

uic 도구는 Qt Designer 로 창조한 폼들에 기초한 파생클라스의 창조를 단순화하기 위 한 지 
령행선택들을 제공한다. - subdecl 를 사용하여 골격머리부파일을 생성하고 - subimpl 을 사용하여 
그와 짝을 이루는 실현파일을 생성한다. 

제4절. 형태가 변하는 대화칸 

앞에서는 고정된 창문부품만이 현시되는 대화칸창조방법을 보았다. 일부 경우에 형태를 
변경할수 있는 대화칸을 제공하여 야 한다. 형 태가 변하는 대화칸에서 2가지 의 가장 일반적 인 
종류가 확장대화칸와 여 러폐지대화칸이 다. 두가지 대화칸은 어에서 순수 코드로 혹은 Qt 
Designer 를 사용하여 실현할수 있다. 

보통 확장대화칸은 간단한 형태로 표시되지만 대화칸의 단순한 형태와 확장된 형태사이 
를 사용자가 절환하게 하는 절환 ( toggle ) 단추를 가지고있다. 확장대화칸은 보통 림시사용자와 
능력있는 사용자들의 요구를 만족시키려고 하는 응용프로그람들에 사용되며 사용자가 구체적 
인 선택을 알려고 정확히 요구하지 않는한 그 선택들을 숨긴다. 이 절에서는 Qt Designer 에 의 
하여 그림 2-13 에 보여주는 확장대화칸을 창조한다. 
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그림 2-13. 단순한 Sort 대화칸와 확장된 Sort 대화칸 

이 대화칸은 표계산프로그람의 Sort 대화칸이다. 여기서 사용자는 정렬하려는 하나이상의 
렬들을 선택할수 있다. 단순한 대화칸은 사용자가 단일한 정렬건을 입력하게 하고 확장된 대 
화칸은 2개의 여분의 정렬건을 제공한다. More 단추는 사용자가 단순한 형태와 확장형태사이를 
절환하게 한다. 

Qt Designer 로 확장형태를 가지는 창문부품들을 창조하고 실행시에 필요할 때 둘째건과 
셋째건을 숨긴다. 창문부품의 창조가 복잡한것같지만 그것은 Qt Designer 로 간단히 수행할수 
있다. 요점은 우선 첫째그룹을 창조하고 다음에 그것을 두번 복사하고 붙이기하여 둘째그룹 
과 셋째그룹을 엄는것이다. 

① 그룹칸 하나, 본문표식자 두개, 복합칸 두개 그리고 수평수축자 하나를 창조한다. 

② 그룹칸의 오른쪽아래구석을 끌어서 늘인다. 

③ 다른 창문부품들을 그룹칸으로 옮기고 그것들을 그림 2-14(1) 에 보여주는것과 근사 
하게 배 치한다. 

④ 둘째 복합칸의 오른변을 끌어서 첫 복합칸폭의 약 두배로 늘인다. 

⑤ 그룹칸의 title 속성 을 "&Primary Key " 로，첫째 표식 자의 text 속성 을 ’’ Column :" 으로，둘째 
표식 자의 text 속성 을 " Order :" 로 설 정한다. 

⑥ 첫째 복합칸을 두번 찰칵하여 Qt Designer 의 목록칸편집 기를 펼치고 본문 " None " 을 가 
지는 항목을 하나 창조한다. 

⑦ 들째 복합칸을 두번 찰칵하고 Ascending 항목과 Descending 항목을 창조한다. 

⑧ 그룹칸을 찰칵한 다음 Layout|Lay Out in a Grid 를 찰칵한다. 이것은 그림 2-14(1) 에 보 
여 주는 배 치 관리 자를 생 성한다. 

배치 가 제대로 되 지 않거 나 오유가 발생하면 늘 Edit|Undo 를 찰칵한 다음 배치할 창문부 
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품들의 위치를 다시 조절하고 다시 배치를 시도한다. 

이제는 Secondary Key 와 Tertiary Key 그룹칸들을 추가한다. 

① 충분히 여유를 주어 대화창문을 크게 만든다. 그룹칸을 선택하고 Edit | Copy 를 찰칵한 
다음 Edit | Paste 를 찰칵하여 두개의 그룹칸을 추가한다. 두개의 새로운 그룹칸을 끌어서 그것 
들이 차지하여야 할 대략적 인 위치로 가져간다. 그것들의 title 속성을 각각 ’’&Secondary Key " 와 
”&Tertiary Key ” 로 변 경 한다. 



기)정리없몸 L> 정리있콤 

그림 2-14. 그룹칸의 자식들을 살창형태로 배치하기 

② OK , Cancel 및 More 단추들을 창조한다. 

③ 0 K 단추의 default 속성 을 True , More 단추의 toggle 속성 을 True 로 설 정 한다. 

④ 두개의 수직수축자를 창조한다. 

⑤ 0도 Cancel 및 More 단추들을 수직 으로 배 렬 하고 Cancel 과 More 단추사이 에 수직 수축자 
를 배 치 한다. 그다음 4개 의 항목을 모두 선 택 하고 Layout | Lay Out Vertically 을 찰칵한다. 

⑥ 주열쇠그룹칸과 둘째건그룹칸사이 에 두번째 수직수축자를 배치 한다. 

⑦ 두개 의 수직 수축자항목들의 s i ze Hint 속성 을 (20, 10) 로 설 정 한다. 

⑧ 창문부품들을 그림 2-15("!) 에 보여주는 살창형식으로 배렬한다. 

⑨ Layout|Lay Out in a Grid 를 찰칵한다. 이제는 폼이 그림 2-15( ᄂ)와 일치된다. 
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그림 2-15. 폼의 자식들을 살창형태로 배치하기 


이 리하여 살창배치 관리 자는 2개의 렬과 4개의 행, 총 8개의 세포를 제공한다. Primary Key 
그룹칸，제 일 왼쪽의 수직 수축자항목, Secondary Key 그룹칸, 및 Tertiary Key 그룹칸은 각각 한개 
세 포씩 차지한다. OK , Cancel 및 More 단추들을 포함하는 수직배 치 관리 자는 두개 의 세 포를 차 
지한다. 대화칸의 오른쪽 아래에 두개의 빈 세포가 남아있다. 이것이 마음에 들지 않으면 배 
치 를 취 소하고 창문부품들을 재 배치하고 다시 배치한다. 

폼의 resizeMode 속성을 Auto 로부터 Fixed 로 변경 하여 대화칸의 크기를 사용자가 조절 할수 
없게 만든다. 그다음 배 치 관리 자는 크기 조절 에 대 한 응답능력 을 넘 겨 밤으며 대 화칸은 자식창 
문부품들이 표시되거나 은폐될 때 크기가 자동조절되여 대화칸이 늘 최량크기로 표시되도록 
한다. 

폼의 이 름을 SortDialog 로, 그 제 목을 Sort 로 변 경한다. 자식창문부품들의 이 름을 그림 
2-16 에 보여 주는것 처 럼 설 정한다. 

끝으로 련 결 들을 설 정한다. 

① okButton 의 clicked () 신호를 폼의 acceptQ 처 리 부에 련결한다. 

② cancelButton 의 clickedO 신호를 폼의 reject () 처 리부에 련결한다. 

③ moreButton 의 toggled ( bool ) 신호를 secondaryGroupBox 의 setShown ( bool ) 처리부에 련결한 
다. 
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그림 2-16. 폼의 창문부품이름 

④ moreButton 의 toggled ( bool ) 신호를 tertiaryGroupBox 의 setShown ( bool ) 처 리 부에 련결 한다. 
폼을 두번 련속 찰칵하여 Qt Designer 의 C ++ 코드편집기를 펼치고 다음의 코드를 입력한 


1 void SortDialog :: init () 

2 { 

3 secondaryGroupBox -> hide () ; 

4 tertiaryGroupBox -> hide (); 

5 setColumnRange (’ A ’，’ Z ’); 

6 } 

7 void SortDialog : : setColumnRange(QChar first , QChar last ) 

8 { 

9 primaryColumnCombo -> clear (); 

10 secondaryColumnCombo -> clear (); 

11 tertiaryColumnCombo -> clear (); 

12 secondaryColumnCombo -> insertItem ( tr ( ,, None n )); 

13 tertiaryColumnCombo -> insertItem ( tr ( M None M )); 

14 primaryColumnCombo -> setMinimumSize ( 

15 secondaryColumnCombo -> sizeHint ()); 

16 QChar ch = first ; 

17 while (ch <= last ) { 

18 primaryColumnCombo -> insertItem ( ch ); 

19 secondary ColumnCombo -〉 insertItem ( ch ); 





20 tertiaryColumnCombo -> insertItem ( ch ); 

21 ch = ch . unicode () + 1; 

22 } 

23} 

initO 함수는 대화칸의 두번째와 세번째그룹부분을 은폐한다. 

setColumnRangeG 처리부는 표에서 선택한 렬에 기초하여 복합칸들의 내용을 초기화한다. 
두번째와 세 번째그룹의 복합칸에 None 항목을 삽입 한다. Qt Designer 의 처 리 부편집 기 를 리 용하 
여 이 처 리부를 창조하지 않았어도 Qt Designer 는 코드에서 새로운 처 리부가 창조된것을 탐지 
하고 uic 는 자동적 으로 SortDialog 클라스정 의 에 정 확한 함수선 언 을 생 성 한다. 

14행과 15행은 배 치 형식 을 보여 준다. QWidget :: sizeHint () 함수는 배치체계가 받아들이 는 창 
문부품의 《리상적인》크기를 돌려준다. 이것은 배치체계에 의하여 서로 다른 종류의 창문부 
품들이나 서 로 다른 내 용을 가지 는 류사한 창문부품들에 각이한 크기 를 할당하는 기 초로 된 
다. 즉 복합칸들에서 이것은 None 을 포함하는 둘째와 셋째 복합칸들이 한개 문자만을 포함하 
는 첫째 복합칸보다 커진다는것을 의미한다. 이려한 비일관성을 피하기 위하여 첫째 복합칸 
의 최 소크기 를 둘째 복합칸의 리 상적 인 크기 로 설 정한다. 

여기서 mainO 은 ' C ’ 〜 ’F 렬을 포함하도록 범 위를 설정 한 다음 대화칸을 표시하는 기능을 
시 험 한다. 

#include < qapplication . h > 

#include " sortdialog . h " 

int main(int argc , char * argv []) 

{ 

QApplication app ( argc , argv ); 

SortDialog * dialog = new SortDialog ; 
app . setMainWidget ( dialog ); 
dialog -> setColumnRange (' C ', ’ F ); 
dialog -> show (); 
return app . exec (); 

} 

이로서 확장대화칸을 완성한다. 실례에서 설명하는것처럼 확장대화칸은 일반대화칸보다 
설계하는것이 그리 힘들지 않다. 필요한것은 절환단추 하나와 여러개의 신호-처리부련결 그 
리고 크기조절할수 없는 하나의 배치관리자이다. 

형래가 변하는 다른 일반대화칸으로서 여러폐지대화칸은 (가에서 코드로 혹은 Qt Designer 
에 의해 실현하는것이 훨씬 간단하다. 여러폐지대화칸은 여러가지 방법으로 만들수 있다. 

- QTabWidget 는 독립적으로 쓰일수 있다. 이것은 웃끝에 내부 QWidgetStack 를 조종하는 타 
브띠를 제공한다. 
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• QListBox 와 QWidgetStack 는 함께 사용할수 있으며 이때 QListBox 의 현재항목을 리용하여 
QWidgetStack 가 표시 할 폐지를 결정한다. 

- QListYiew 혹은 QlconView 는 QListBox 와 비 슷한 방법 으로 QWidgetStack 에서 사용될 수 있 
다. 

QWidgetStack 클라스는 《6장. 배치관리》에서 설명한다. 

제5절. 동적대화칸 

동적대화칸은 실행시에 Qt Designer 의 . ui 파일로부터 창조되는 대화칸이다. 동적대화칸은 
uic 에 의해 C ++ 코드로 변환되 지 않는다. 그대신에 . ui 파일은 다음과 같은 방법 으로 실행시 에 
QWidgetFactory 클라스에 의 하여 적재된다. 

QDialog *sortDialog = (QDialog *) QWidgeffactoty :: create (" sortdialog . ui "); 

QObjectxhildO 에 의 하여 폼의 자식창문부품들을 호출할수 있다. 

QComboBox *primaryColumnCombo = (QComboBox *) sortDialog -> 
child (" primaryColumnCombo ", " QComboBox "); 

child () 함수는 대화칸이 주어진 이름과 형이 일치하는 자식을 가지지 않으면 null 지적자를 
돌려 준다. 

QWidgetFactory 클라스는 개별적인 서고에 배치된다. Qt 응용프로그람으로부터 

QWidgetFac 加 y 를 사용하려면 다음 행을 응용프로그람의 . pro 파일에 추가해야 한다. 

LIBS += -lqui 

이 문법은 모든 가동환경에서 적용할수 있다. 

동적대화칸은 응용프로그람을 다시 콤파일하지 않고도 폼의 배치를 변경할수 있게 한다. 

제6절. 기본창문부품과 대화칸클라스 

Qt 는 대부분의 상황에 적합한 기본창문부품과 공통대화칸들을 제공한다. 이 절에서는 그 
것 들에 대하여 소개 한다. 일부 전문화된 창문부품들은 후에 언급한다. QMenuBar , QPopupMenu , 
QToolBar 와 같은 기본창문창문부품들은 제3장에서 설명하고 QDataView , QDataTable 과 같은 자 
료기지창문부품들은 제12장에서 설명한다. 대부분의 기본창문부품과 대화칸은 이 책에서 제 
시하는 실례들에서 사용된다. 아래의 그림들에서 창문부품들은 전형적인 Windows 형식으로 보 
여준다. 


0K | |7 Match case 

C Ascending 

Cancel I 「 Search backward 

(* Descending 

QPushButton QCheckBox 

QRadioButton 


그림 2-17. Qt 의 단추창문부품들 

아는 세 종류의 단추 즉 QPushButton , QCheckBox , QRadioButton 을 제 공한다. QPushButton 은 
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찰칵할 때 작용을 초기화하는데 제일 많이 쓰이지만 절환단추와 같이 동작할수도 있다. 
QRadioButton 은 보통 QButtonGroup 안에서 서로 배타적인 선택에 쓰이고 QCheckBox 는 독립적 
인 on / off 선택에 쓰인다. 

Qt 의 용기창문부품은 다른 창문부품들을 포함하는 창문부품이 다. 또한 QFrame 은 단순히 
그 자체에 직선을 그리는데 쓰이며 다른 수많은 창문부품클라스 특히 QLabel 과 QLineEdit 이 
그것 을 계 승한다. QButtonGroup 는 표시 되 지 않으며 시 각적 으로 QGroupBox 와 등가하다. 



CTabWidget QToolBox 

그림 2-18. Qt 의 용기창문부품들 

QTabWidget 와 QToolBox 는 여 러 폐지창문부품이 다. 매개 폐지 는 하나의 자식창문부품이고 
폐지들에는 0부터 번호가 불는다. 
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항목보기는 대량자료를 조종할수 있도록 최적화되며 흔히 흘림띠를 사용한다. 흘림띠기구 


항목보기와 다른 종류의 보기들의 기초클라스인 QScrollView 에 의해 실현된다. 


W^tniing: ᅬ I ursav&cl 
infarmatior will be lost! 


m\ w 




그림 2-20. Qt 의 현시창문부품들 

Qt 는 순수 정보를 현시하는데 쓰이는 창문부품들을 제공한다. QLabel 은 그중에서 가장 중 
요하며 리치본문(단순한 HTML 형식의 문법을 리용)과 화상을 표시하는데 쓰인다. 

QTextBrowser (표시되지 않는다)는 목록, 표，화상，초본문련결을 비롯한 기본 HTML 기능을 
가지는 읽기전용의 QTextEdit 파생클라스이다. Qt Assis 切 nt 는 QTextBrowser 에 의하여 사용자에게 
문서 를 표시한다. 
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QLineEdit 

QConboBox 


QSpinBox 
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111:59:59 

QDateBdit 

QDateTimeCdit 


QTiroeEdit 

—— J— 

- 」 

J 

上 J 

QSlider 

QScrollBar 


Being a retired professor is a lot ike being an 
ordinary profewor, except that you con't 
have to write research proposals, adninister 
grants, or sit in BM 텔 meetnga. 식 so, you 
don't get paid 

QTextEdit QDial 

그림 2-21. Qt 의 입 력창문부품들 

Qt 는 자료를 입력 하는 창문부품들을 제공한다. QLineEdit 는 입력 마스크나 유효기 ( validator ) 
의하여 그 입 력을 제한할수 있다. QTextEdit 는 대 량적 인 본문을 편집할수 있는 QScrollView 
파생 클라스이 다. 




QColorDialog QFontDia： 


그림 2-22. (경의 색대화칸와 서 체대화칸 
사용자가 색. 서체 혹은 파일을 간단히 선택하거나 문서를 인쇄경 


















QFileDialog 


QPrintDialog 


그림 2-23. (가의 파일대화칸와 인쇄대화칸 
Mac OS 표에서 어는 될수록 자체의 공통대화칸이 아니라 원시대화칸- 









롬 


System Requirements 



jrtingtt 
have been completed: 


Before starting this wizard, be sure the following steps 


♦ Installction of the Operating System 

♦ Installction of the Application Server 

♦ Filling out the Configuration Work$heet$ 

If any of the above steps still need to be ccmpleted, 
click Cancel to close this 初 zard and restart it when 
you have completed all the requirements. 


Cancel | 


| Next > 


그림 2-25. 어의 QWizard 대 화칸 

사용할 준비 가 되 여있는 수많은 기 능이 기 본창문부품과 공통대 화칸들에 의해 제 공된다. 
더 전문화된 요구들은 흔히 신호들을 처리부들에 련결하고 처리부들에서 사용자정의동작을 
실현함으로써 충족시킨다. 

일부 경 우에서 사용자정 의창문부품을 창조해 야 한다. Qt 는 이 것을 간단히 수행하며 사용 
자정 의 창문부품들은 Qt 의 기 본창문부품들처 럼 갈은 가동환경 에 의 존하지 않는 그리 기 기 능을 
모두 호출할수 있다. 지 어는 사용자정의창문부품들을 Qt Designer 에 통합하여 Qt 의 기본창문부 
품들과 갈은 방법 으로 사용할수 있다. 제 5장에 서 는 사용자정 의창문부품창조방법 을 설 명한다. 
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표계 산프로그람에 서 기 본창문의 원천코드는 mainwindow.h 와 mainwindow.cpp 에 들어 있다. 
머리부파일은 다음과 같다. 

#ifndef MAINWINDOW_H 
#defme MAINWINDOW 一 H 
#include < qmainwindow . h > 

#include < qstringlist . h > 
class QAction ; 
class QLabel ; 
class FindDialog ; 
class Spreadsheet ; 

class MainWindow : public QMainWindow 

{ 

Q_OBJECT 

public : 

MainWindow(QWidget ^parent = 0, const char *name = 0); 
protected : 

void closeEvent(QCloseEvent * event ); 

void contextMenuEvent(QContextMenuEvent * event ); 

MainWindow 클라스를 QMainWindow 의 파생 클라스로서 정 의 한다. 이것은 자체 의 신호와 
처리부를 제공하므로 Q_OBJECT 마크로를 포함한다. 

closeEvent () 함수는 사용자가 창문을 닫을 때 자동적으로 호출되는 QWidget 의 가상함수이 
다. 이 것 은 MainWindow 에 서 사용자에 게 표준질문 "Do you want to save your changes ?" 를 표시 하 
고 디스크에 사용자의 선택을 보관하도록 재정의한다. 

마찬가지 로 contextMemiEvent () 함수는 사용자가 창문부품을 오른단추로 찰칵하거 나 가동환 
경에 고유한 차림표건을 누를 때 호출된다. 이것은 MainWindow 에서 상황차림표를 펄치도록 
재정의된다. 
private slots : 

void newFile (); 
void open (); 
bool save (); 
bool saveAs (); 
void find (); 
void goToCell (); 
void sort (); 
void about (); 
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File|New 와 Help|About 와 같은 일부 차림표선택들은 MainWindow 에서 비공개처 리부들로서 
실현된다. 대부분의 처리부들은 돌림값으로서 void 를 가지지만 save () 와 saveAs () 는 bool 을 돌 
려준다. 돌림값은 신호에 응답하여 처리부가 실행될 때 무시되지만 함수로서 처리부를 호출 
할 때 돌림값은 보통의 C ++ 함수를 호출할 때처럼 사용할수 있다. 
void updateCellIndicators (); 
void spreadsheetModified (); 
void openRecentFile(int param ); 
private : 

void createActions (); 
void createMenus (); 
void createToolBars (); 
void createStatusBar (); 
void readSettings (); 
void writeSettings (); 
bool maybeSave (); 

void loadFile(const QString & fileName ); 
void saveFile(const QString & fileName ); 
void setCurrentFile(const QString & fileName ); 
void updateRecentFileItems (); 

QString strippedName(const QString & fullFileName ); 

기 본창문은 사용자대 면부를 유지하기 위 한 많은 비 공개 처 리부들과 여 러 개의 비 공개 함수 
들을 요구한다. 

Spreadsheet ^ spreadsheet ; 

FindDialog * findDialog ; 

QLabel * locationLabel ; 

QLabel * formulaLabel ; 

QLabel * modLabel ; 

QStringList recentFiles ; 

QString curFile ; 

QString fileFilters ; 
bool modified ; 

enum { MaxRecentFiles = 5 }; 
int recentFileIds [ MaxRecentFiles ]; 

QPopupMenu * fileMenu ; 

QPopupMenu * editMenu ; 
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QPopupMenu * selectSubMenu ; 

QPopupMenu * toolsMenu ; 

QPopupMenu * optionsMenu ; 

QPopupMenu * helpMenu ; 

QToolBar * fileToolBar ; 

QToolBar * editToolBar ; 

QAction * newAct ; 

QAction * openAct ; 

QAction * saveAct ; 

QAction * aboutAct ; 

QAction * aboutQtAct ; 

}； 

#endif 

또한 MainWindow 는 비공개처리부，비공개함수들과 함께 수많은 비공개변수들을 가전다. 
이 것 들은 사용할 때 설 명한다. 

이제 그 실현을 고찰하자. 

#include < qaction . h > 

#include < qapplication . h > 

#include < qcombobox . h > 

#include < qfiledialog . h > 

#include < qlabel . h > 

#include < qlineedit . h > 

#include < qmenubar . h > 

#include < qmessagebox . h > 

#include < qpopupmenu . h > 

#include < qsettings . h > 

#include < qstatusbar . h > 

#include " cell . h ” 

#include " finddialog 上" 

#include " gotocelldialog . h ” 

#include " mainwindow . h M 
#include " sortdialog . h " 

# include " spreadsheet . h " 

파생클라스에서 사용하는 Qt 클라스들의 머리 부파일들과 일부 사용자정의 머리부파일 특히 
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2 장의 finddialog.h ， gotocelldialog.li ， sortdialog.h 들을 포함한다 . 

MainWindow: : MainWindow(QWidget ^parent, const char *name) : QMainWindow(parent, name) 

{ 

spreadsheet = new Spreadsheet(this); 

setCentralWidget(spreadsheet); 

create Actions。; 

createMenus(); 

createToolBars(); 

create StatusBar(); 

readSettings(); 

setCaption(tr( M Spreadsheet M )); 
setIcon(QPixmap::fromMimeSource( n icon.png n )); 
findDialog = 0; 

fileFilters = tr("Spreadsheet files (*.sp)"); 
modified = false; 

} 

구성 자에 서 는 Spreadsheet 창문부품을 창조하여 기 본창문의 중심창문부품으로 설 정 하는것 
으로 시 작한다 . 중심창문부품은 도구띠 들과 상태 띠 사이 의 구역 을 차지한다 . Spreadsheet 클라스 
는 표계산식들의 유지와 갈은 표계산능력을 갖춘 QTable 의 파생클라스이다 . 그것을 4 장에서 
실현한다 . 



그림 3-2. QMainWindow 의 구성 창문부품들 

그다음 비공개함수들인 createActions(), createMenus(), createToolBars(), createStatusBar () 를 호 
출하여 기 본창문의 나머 지 를 창조한다 . 또한 비 공개 함수 readSettingsO 를 호출하여 기 억 되 여있 
는 응용프로그람의 환경설정을 읽어들인다 . 

창문의 그림 기 호를 PNG 파일 인 icon.png 로 설 정 한다 . Qt 는 BMP, GIF, JPEG, MNQ PNQ PNM, 








XBM 및 XPM 을 비 롯한 수많은 화상형 식 을 제 공한다. QWidget :: setIcon () 을 호출하여 창문의 왼 
쪽웃구석에 그림기호가 표시되게 설정한다. 가동환경에 의존하지 않고 탁상우에 나타나는 응 
용프로그람그림기호를 설정하는 방법은 없다. 

일반적으로 GUI 응용프로그람들은 수많은 화상들을 사용하고 일부 화상은 여러개의 다른 
상황에서 사용된다 . Qt 는 응용프로그람에 화상을 제공하는 여러가지 방법을 가지고있다. 

가장 일반적 인 방법은 다음과 갈다. 

• 파일 들에 화상을 보관하였 다가 실 행 시에 적 재 하기 . 

- 원천코드에 XPM 파일들을 포함하기. (이것은 XPM 파일들도 유효한 C ++ 파일들이므로 제 
대로 동작한다.) 

• Q t 의 《화상집합》기구의 사용. 

여기서는 실행시에 파일을 적재하는것보다 간단하면서 효과적인 화상집합수법을 리용한 
다. 이 것은 유지 되 여있는 파일형 식으로 작업한다. 화상들은 images 라고 부르는 보조등록부안 
의 원천나무에 보관된다. 응용프로그람의 .pro 파일에 다음의 코드 

IMAGES = images / icon.png \ 
images / new.png \ 
images / open.png \ 

images / find.png \ 
images / gotocell.png 

를 추가함으로써 uic 가 지정된 화상모두에 대한 자료를 포함하는 C ++ 원천코드파일을 생성하 
게 한다. 그다음 자료는 응용프로그람의 실행파일로 를파일되고 QPixmap::fromMimeSourceO 에 
의하여 얻을수 있다. 이것은 그림기호와 기타 화상들이 적재되여 항상 실행가능상태에 있다 
는 우점이 있다. 

Qt Designer 에 의하여 대화칸은 물론 기본창문을 창조한다면 그것을 리용하여 .pro 파일을 
조종할수 있고 화상들을 화상집합에 시각적으로 추가할수 있다. 

제2절. 차림표와 도구띠의 만들기 

대부분의 GUI 응용프로그람들은 차림표와 도구띠를 모두 제공하며 일반적으로 차림표와 
도구띠는 갈은 지령들을 포함한다. 차림표는 사용자들이 응용프로그람을 조사하고 새로운 기 
능을 호출할수 있게 하고 도구띠는 흔히 사용하는 기능에 대한 고속호출을 제공한다. 

Qt 는 《작용》개념을 통하여 차림표와 도구띠의 프로그람작성을 단순화한다. 작용 ( action ) 
은 하나의 차림표，하나의 도구띠，혹은 차림표와 도구띠에 모두 추가할수 있는 항목이다. Qt 
에서 차림표와 도구띠는 다음과 갈은 단계를 통하여 창조된다. 

• 작용들을 창조한다. 

• 작용들을 차림표에 추가한다. 

• 작용들을 도구띠 에 추가한다. 
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표계산프로그람에서 작용들은 createActions () 에서 창조된다. 
void MainWindow : : createActions () 

{ 

newAct = new QAction ( tr ("& New "), tr ( M Ctrl + N "), this ); 
newAct -> setIconSet ( QPixmap :: fromMimeSource (" new . png ")); 
newAct -> setStatusTip ( tr( M Create a new spreadsheet file ")); 
connect ( newAct , SIGNAL ( activated ()), this , SLOT ( newFile ())); 

New 작용은 작용이 름 ( New ), 지 름건 ( Ctrl + N ), 부모(기 본창문), 그림 기 호 ( new . png ), 그리 고 상 
태암시 를 가전 다. 작용의 activatedO 신 호를 기 본창문의 비 공개 성 원 newFileO 처 리 부에 련 결 한다. 
이것은 다음 절에서 실현한다. 련결이 없으면 사용자가 File|New 차림표항목을 선택하거나 New 
도구띠단추를 찰칵할 때 아무런 반응도 없다. 


File , Edit , Tools 차림 표의 다른 작용들은 New 작용과 아주 비 슷하다. 



그림 3-3. 표계산프로그람의 차림표 


Options 차림 표의 Show Grid 작용은 다르다. 
showGridAct = new QAction ( tr("&Show Grid ”), 0, this ); 
showGridAct -> setToggleAction ( true ); 
showGridAct -> setOn ( spreadsheet -> showGrid ()); 
showGridAct -> setStatusTip ( tr("Show or hide the spreadsheet's grid ’’)); 

connect ( showGridAct , SIGNAL ( toggled ( bool )), spreadsheet , SLOT ( setShowGrid ))); 

Show Grid 는 절환 ( toggle ) 작용이다. 이것은 차림표에서 검사표식으로 표시되고 도구띠에서 
절환단추로서 실현된다. 작용이 on 일 때 Spreadsheet 부분품은 살창을 현시한다. 작용을 
Spreadsheet 부분품의 기정값으로 초기화하여 그것들을 기동시 에 동기시킨다. 그다음 Show Grid 
작용의 toggled ( bool ) 신호를 QTable 로부터 계승하는 Spreadsheet 부분품의 setShowGrid ( bool ) 처리 
부에 련결한다. 일단 이 작용이 차림표 혹은 도구띠 에 추가되면 사용자는 살창의 on/off 를 절 
환할수 있다. 

Show Grid 와 Auto-recalculate 작용들은 독립적인 절환작용들이다. 또한 QAction 는 


48 





QActionGroup 파생클라스를 통하여 호상 배타적 인 작용들을 제공한다 . 
aboutQtAct = new QAction ( 仕 ("About &Qt"), 0, this); 
aboutQtAct->setStatusTip(tr("Show the Qt library 의 About box")); 
connect(aboutQtAct, SIGNAL(activated()), qApp, SLOT(aboutQt())); 

} 

About Qt 에 서 는 qApp 대 역 변 수를 통하여 호출할수 있는 QApplication 객 체 의 aboutQt () 처 리 
부를 리용한다 . 

이제는 작용들을 창조하였으므로 작용들을 호출할수 있는 차림표체계의 작성에로 넘어갈 
수 있다 . 

Q Aboum 

This program us 的 Qt version 3.2.0. 

Qt is a C++ toolkit for multiplatfDrm GUI 8t application development. 

Qt provide3 single-source portability across MS Window' Mac OS X, Linux, 
and all major commercial Unix variants. 

Qt is also available for embedded devices. 

Qt ia a Trolltech product. See http : //www. trolltech. com/qt/ for more 
information. 

[三] 


그림 3-4. About Qt 

void MainWindow: :createMenus() 

{ 

fileMenu = new QPopupMenu(this); 
newAct->addTo(fileMenu); 
openAct->addTo(fileMenu); 
saveAct->addTo(fileMenu); 
saveAsAct->addTo(fileMenu); 
fileMenu->insertSeparator(); 
exitAct->addTo(fileMenu); 
for (int i = 0; i < MaxRecentFiles; ++i) 
recentFileIds[i] = -1; 

(가에서 모든 차림표는 QPopupMenu 의 실례들이다 . File 차림표를 창조한 다음 거기에 New, 
Open, Save, Save As, Exit 작용들을 추가한다 . 분리선을 추가하여 밀접히 련관된 항목들을 모두 
시각적으로 묶는다 . for 순환을 리용하여 recentFilesIds 배럴을 초기화한다 . 다음 절에서 File 차림 
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표처리부들을 실현할 때 recentFilesIds 을 리용한다. 
editMenu = new QPopupMenu(this) ; 
cutAct->addTo(editMenu); 
copyAct->addTo(editMenu); 
pasteAct->addTo(editMenu); 
deleteAct->addTo(editMenu); 
selectSubMenu = new QPopupMenu(this); 
selectRowAct->addTo(selectSubMenu); 
selectColumnAct->addTo(selectSubMenu); 
selectAllAct->addTo(selectSubMenu); 
editMenu->insertItem(tr( M &Select n ), selectSubMenu); 
editMenu->insertSeparator(); 
findAct->addTo(editMenu); 
goToCellAct->addTo(editMenu); 

Edit 차림표는 하나의 보조차림표를 포함한다. 보조차림표는 그것이 속하는 차림표처럼 
QPopiipMenu 이다. 단순히 this 를 부모로 가지는 보조차림표를 창조하여 그것을 표시 하려는 
Edit 차림표에 삽입한다. 

toolsMenu = new QPopupMenu(this); 
recalculateAct->addTo(toolsMenu); 
sortAct->addTo(toolsMenu); 
optionsMenu = new QPopupMenu(this); 
showGridAct->addTo(optionsMenu); 
autoRecalcAct->addTo(optionsMenu); 
helpMenu = new QPopupMenu(this); 
aboutAct-〉addTo(helpMenu); 
aboutQtAct->addTo(helpMenu); 
menuBar()-〉insertItem(tr("&File"), fileMenu); 
menuBar()->insertItem(tr("&Edit n ), editMenu); 
menuBar()->insertItem(tr( M &Tools n ), toolsMenu); 
menuBar()->insertItem(tr("&Options n ), optionsMenu); 
menuBar()->insertSeparator(); 
menuBar()->insertItem(tr("&Help M ), helpMenu); 

} 

류사한 방법 으로 Tools, Options, Help 차림 표들을 만들어 모든 차림 표를 차림 표띠 에 삽입한 
다. QMainWindow::menuBar() 함수는 QMenuBar 의 지적자를 돌려준다. (차림표띠는 menuBar() 가 
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처 음으로 호출될 때 창조된다 .) Options 와 Help 차림 표사이 에 분리 선을 삽입한다 . Motif 형 식 에서 
분리선은 Help 차림표를 오른쪽에 배치하며 다른 형식들에서 분리선은 무시된다 . 


He git Tools Aborts 


「 ‘ 볘。出 0_구 빼 _ 



그림 3-5. Motif 와 Windows 형 식 들에 서 차림 표띠 
도구띠의 창조는 차림표창조와 아주 비슷하다 . 
void MainWindow: : createToolBars() 

{ 

fileToolBar = new QToolBar(tr( M File M ), this); 

newAct->addTo(fileToolBar); 

openAct->addTo(fileToolBar); 

save Act->addTo(fileToolBar); 

editToolBar = new QToolBar(tr( M Edit"), this); 

cutAct->addTo(editToolBar); 

copyAct->addTo(editToolBar); 

pasteAct->addTo(editToolBar); 

editToolBar->addSeparator(); 

findAct->addTo(editToolBar); 

goToCellAct->addTo(editToolBar); 

} 

File 도구띠 와 Edit 도구띠 를 창조한다 . 튀 여나오기 차림 표처 럼 도구띠 는 분리 선 을 가질 수 있 
다 . 

IJ1D 句 Bi niKSi 逆 > 1 松 

그림 3-6. 표계산프로그람의 도구띠 

이제는 차림표와 도구띠를 만들었으므로 상황차림표를 추가하여 대면부를 완성한다 . 

void MainWindow: : contextMenuEvent(QContextMenuEvent *event) 

{ 

QPopupMenu contextMenu(this); 
cutAct->addTo(&contextMenu); 
copyAct->addTo(&contextMenu); 
pasteAct->addTo(&contextMenu); 
contextMenu.exec(event->globalPos()); 




} 

사용자가 오른쪽 마우스단추를 찰칵할 때(혹은 일부 건반우에 있는 Menu 건을 누를 때 ), 
《상황차림표》사건이 창문부품에 전송된다 . QWidget :: contextMenuEvent () 함수를 재정의하여 이 
사건에 응답할수 있으며 현재의 마우스유표위치에 상황차림표를 펼친다 . 


복然 Cut 

Ctrl+X 

[3 £°py 

Ctrl+C 

(?S £ 너 ® 

CtrkV 


그림 3-7. 표계산프로그람의 상황차림표 

신호와 처 리 부처럼 사건은 Qt 프로그람작성의 기 초개 념 이 다 . 사건 (event ) 은 (가의 핵심 에 의 
해 생성되여 마우스찰칵，건누르기，크기조절요구 및 류사한 경우를 통보한다 . 여기서 수행한 
것처럼 가상함수들을 재정의하여 사건들을 조종할수 있다 . 

MainWindow 에 차림표의 작용들을 보관하였으므로 여기서 상황문맥차림표를 실현하기로 
하였지만 Spreadsheet 에 실현할수도 있다 . 사용자가 Spreadsheet 창문부품을 오른쪽 단추로 찰칵 
할 때 아는 상황차림표사건을 그 창문부품에 우선 전송한다 . Spreadsheet 가 contextMenuEvent() 
를 재정의하여 사건을 조종하면 사건은 거기서 정지하며 그렇지 않으면 부모 (MainWindow ) 에 
송신된다 . 사건은 7 장에서 완전히 설명된다 . 

상황차림 표사건 처 리 함수는 탄창에 변수로서 창문부품 (QPopupMenu ) 을 창조하므로 지 금까 
지 보아온 모든 코드와는 다트다 . new 와 delete 를 사용하여 간단히 창조할수 있다 . 

QPopupMenu *contextMenu = new QPopupMenu ( 仕 iis); 

cutAct->addTo(contextMenu); 

copyAct->addTo(contextMenu); 

pasteAct->addTo(contextMenu); 

contextMenu->exec(event->globalPos()); 

delete contextMenu; 

또 하나의 중요한 코드는 exec() 호출이다 . QPopupMenu::exec () 는 주어진 화면위치 에 튀 여나 
오기 차림 표를 표시 하고 사용자가 차림 표항목을 선택 할 때까지(혹은 튀 여나오기 차림 표가 없어 
질 때까지 ) 기다린다 . 이 시점에서 QPopupMenu 객체는 자기의 목적을 달성하였으므로 그것을 
해체할수 있다 . QPopupMenu 객체가 탄창에 배치되면 그것은 함수의 끝에서 자동적으로 해체되 
고 그렇지 않으면 delete 를 호출해야 한다 . 

이제는 차림표와 도구띠의 사용자대면부를 완성하였다 . 아직도 모든 처리부를 실현하지 
못했고 File 차림표의 최근에 연 파일들을 조종하는 코드를 쓰지 못했다 . 다음의 두개 절에서 
그 부분을 완성한다 . 


52 




제 3 절. File 차림표의 실현 

이 절에서는 File 차림표가 동작하게 하는데 필요한 처리부와 비공개함수들을 실현한다 . 
void MainWindow :: newFile() 

{ 

if (maybeSave()) { 
spreadsheet->clear(); 
setCurrentFile ( ,M ')； 

} 

} 

newFile() 처 리 부는 사용자가 File|New 차림표를 찰칵하거 나 New 도구띠 단추를 찰칵할 때 호 
출된 다 . maybeSaveQ 비공개 함수는 보관안된 변경이 있으면 사용자에게 ’’Do you want to save your 
changes?” 라고 묻는다 . 사용자가 Yes 혹은 No (문서를 보관할 때 Yes) 를 선택하면 true 를 돌려 주 
고 사용자가 Cancel 을 선택하면 false 를 돌려 준다 . setCurrentFileO 비공개 함수는 새로 만든 파일 
은 제목이 없으므로 창문제목을 기정제목으로 설정한다 . 
bool MainWindow: : maybeSave() 

{ 

if (modified) { 

int ret = QMessageBox: : waming(this, tr("Spreadsheet M ), 
tr("The document has been modifiedAn" 

"Do you want to save your changes?"), 

QMessageBox: : Yes | QMessageBox::Default, QMessageBox: :No, 
QMessageBox: : Cancel | QMessageBox: : Escape); 
if (ret == QMessageBox: : Yes) 
return save(); 

else if (ret == QMessageBox: : Cancel) 
return false; 

} 

return true; 

} 

maybeSaveO 에서는 그림 3-8 에 보여주는 통보창을 현시한다 . 통보창은 Yes, No, Cancel 단추 
를 가진 다 . QMessageBox: : Default^ Yes 를 기 정 단추로 만든다 . QMessageBox: : Escaped Esc 건 을 
Cancel 과 같은 의미로 만들어준다 . 
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Do you want to 3ave your changes? 


Yes 


그림 3-8. 변경된 문서에 파일의 보관을 물어보는 통보창 
wamingO 의 호출은 첫눈에 좀 복잡해보이지만 일반문법은 간단하다 . 

QMQss^gQBox::w3ming(parent,caption,messageText, buttonO, button 1 ， ...)； 

또한 QMessageBox 는 waming() 처 럼 동작하지만 각이 한 그림 기호를 현시 하는 information(), 
question(), critical() 을 제공한다 . 

、令 公 쇼 o 

Information Question Warning Critical 

그림 3-9. 통보창그림기호 

void MainWindow: :open() 

{ 

if (maybeSave()) { 

QString fileName = QFileDialog::getOpenFileName(".", fileFilters, this); 

if (! fileName .isEmpty()) 
loadFile(fileName); 

} 

} 

open() 처 리 부는 File|Open 에 대 응된 다 . newFile() 처 럼 open() 처 리 부는 우선 maybeSave() 를 호 
출하여 보관하지 않은 변경 을 조종한다 . 그다음 정 적 편의함수 QFileDialog::getOpenFileName() 
에 의하여 파일이름을 얻는다 . 이 함수는 파일대화칸을 펼치고 사용자가 파일을 선택하면 파 
일이름(혹은 사용자가 Cancel 을 찰칵하면 빈문자렬)을 돌려준다 . 

getOpenFileNameO 함수에 3 개의 인수를 준다 . 첫째 인수는 기동하려는 등록부，이 경우에 
현재등록부를 함수에 알린다 . 둘째 인수 fileFilters 는 파일려과기들을 지정한다 . 파일려과기는 
파일 형 이 름과 확장자로 이 루어 진다 . MainWindow 구성 자에서 fileFilters 는 다음과 같이 초기 화된 
다 . 


fileFilters = 仕 ("Spreadsheet files (*.sp )")； 

Spreadsheet 의 원시 파일 형 식 과 함께 반점 으로 구분된 값 (CSV, comma-separated value) 들의 파 
일， Lotus 1-2-3 파일을 유지하려면 변수를 다음과 같이 초기화하여야 한다 . 
fileFilters = 仕 (’’Spreadsheet files (*.sp)\n" 







"Comma-separated values files (*.csv)\n M "Lotus 1-2-3 files (*.wk?) M ); 

끝으로 getOpenFileName() 의 셋째 인수는 펼쳐지는 QFileDialog 가 기본창문의 자식으로 되 
여야 한다는것을 지정한다 . 

부모-자식관계는 대화칸에서 다른 창문부품에서와 같은 의미가 아니다 . 대화칸은 늘 제일 
웃준위 창문부품(자체가 창문)이지만 그것이 부모를 가지면 기정으로 부모의 우에 중심에 배 
치 된 다 . 또한 자식 대 화칸은 부모의 과제 띠항목을 공유한다 . 
void MainWindow: :loadFile(const QString &fileName) 

{ 

if (spreadsheet->readFile(fileName)) { 
setCurrentFile(fileName); 
statusBar()->message(tr("File loaded"), 2000); 

} else { 

statusBar()->message(tr("Loading canceled"), 2000); 



loadFile() 비공개함수는 파일을 적재하기 위하여 open() 에서 호출된다 . 최근에 연 파일들을 
적재하는데 갈은 기능이 필요하므로 그것을 독립적 인 함수로 만든다 . 

Spreadsheet::readFile(} 에 의 하여 디 스크로부터 파일을 읽어 들인다 . 적재 에서 성공하면 
setCurrentFileO 을 호출하여 창문의 제목을 갱신한다 . 그렇지 않으면 Spreadsheet::loadFile(} 은 사 
용자에게 통보창을 통하여 문제점에 대하여 미리 통지한다 . 일반적으로 저준위부분품들이 오 
유에 대한 정확한 내용을 제공할수 있으므로 오유통보문을 내게 하는것이 좋다 . 

두 경우에 2000ms(2s：) 동안 상태띠에 통보문을 현시하여 응용프로그람이 수행하는 일을 사 
용자가 알수 있게 한다 . 
bool MainWindow: : save() 

{ 

if (curFile.isEmpty()) { 
return saveAs(); 

} else { 

saveFile(curFile); 
return true; 

} 

} 

void MainWindow :: saveFile(const QString &fileName) 


if (spreadsheet->writeFile(fileName)) { 
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setCurrentFile(fileName); 
statusBar()->message(tr("File saved"), 2000); 

} else { 

statusBar()->message(tr("Saving canceled"), 2000); 



saveQ 처리부는 File|Save 에 대응된다 . 파일이 이전에 열렸거나 이미 보관되였기때문에 파 
일에 이미 이름이 있으면 save() 는 그 이름으로 saveFileO 를 호출하고 그렇지 않으면 단순히 
saveAs() 를 호출한다 . 

bool MainWindow :: saveAs() 

{ 

QString fileName = QFileDialog::getSaveFileName( n .", fileFilters, this); 

if (fileName.isEmptyO) 
return false; 

if (QFile::exists(fileName)) { 

int ret = QMessageBox: : waming(this, tr( n Spreadsheet"), tr("File %1 already exists. \n M 
’’Do you want to overwrite it?’’) 
.arg(QDir::convertSeparators(fileName)), 

QMessageBox: : Yes | QMessageBox: : Default, 

QMessageBox: : No | QMessageBox::Escape); 
if (ret = QMessageBox: : No) 
return true; 

} 

if (!fileName.isEmptyO) 
saveFile(fileName); 

return true; 

} 

saveAs() 처 리부는 File|Save As 에 대응된다 . QFileDialog::gd:SaveFileName() 를 호출하여 사용 
자로부터 파일이름을 얻는다 . 사용자가 Cancel 을 찰칵하면 false 를 돌려주는데 이것은 
maybeSaveO 까지 전달된다 . 그렇 지 않으면 돌아온 파일 이 름은 새로운 이 름이거 나 현존파일의 
이름이다 . 현존파일의 경우에는 QMessageBox :: wamingO 를 호출하여 그림 3-10 에 보여주는 통 
보창을 현 시한다 . 


56 





그 !H ° x 


• \ File Aiome)li3d/3heet3/j3opulation.3p clready exists. 
Do /ou want to overwrite it? 


Ves | No 


그림 3-10. 겹쳐쓰겠는가를 물어보는 통보창 
통보창에 넘긴 본문은 다음과 갈다 . 
tr("File %1 already exists\n M 

’’Do you want to override it?") 

.arg(QDir::convertSeparators(fileName)) 

QS 仕 ing :: arg() 함수는 "%n" 파라메터를 그 인수로 바꾸고 결과문자렬을 돌려준다 . 례를 들면 
파일이름이 A:\tab04.sp 이면 우의 코드는 다음과 같다 . 

’’File A:\\tab04.sp already existsAn" 

’’Do you want to override it?" 

이것은 응용프로그람이 다른 언어로 번역되지 않는것을 전제로 하고있다 . 

QDir::convertSeparators() 호출은 (가가 이식가능한 등록부분리기호로 사용하는 사선들을 가동환 
경에 고유한 분리기 호 (Unix 와 Mac OS 표에서 'Windows 에서 ’\’ on) 로 변환한다 . 
void MainWindow :: closeEvent(QCloseEvent *event) 

{ 

if (maybeSave()) { 
writeSettings(); 
event->accept(); 

} else { 

event->ignore(); 

} 

} 

사용자가 File|Exit 를 찰칵하거나 창문제목띠의 x 를 찰칵할 때 QWidget::close() 처리부가 호 
출된다 . 이것은 close 사건을 창문부품에 송신한다 . QWidget :: closeEvent() 를 재정의함으로써 기본 
창문을 담으려는 시도를 받아들이고 창문을 담으려고 하는가 아닌가를 결정할수 있다 . 

보관하지 않은 변경 내용이 있는데 사용자가 Cancel 을 선택하면 그 사건을《무시》하고 창 
문은 그대로 남아있다 . 그렇지 않으면 사건을 받아들이고 Qt 에서는 창문을 닫으며 응용프로 
그람을 완료한다 . 

void MainWindow::setCurrentFile(const QString &fileName) 

{ 
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curFile = fileName; 
modLabel->clearO ； 
modified = false; 


if (curFile.isEmpty()) { 

setCaption(tr(" Spreadsheet")); 

} else { 

setCaption(tr("%l -%2").arg(strippedName(curFile)).arg(tr( n Spreadsheet"))); 

recentFiles.remove(curFile); 

recentFiles.push_front(curFile); 

updateRecentFileItems(); 

} 

} 

QString MainWindow: : strippedName(const QString &fullFileName) 

{ 

return QFileInfo(fullFileName).fileName(); 

} 

setCurrenffileO 에서는 편집중에 있는 파일의 이름을 보관하는 curFile 비공개변수를 설정하 
고 MOD 상태지시자를 지우고 제목을 갱신한다 . 두개의 %«파라메터에 대하여 arg() 를 사용한 
다 . arg() 의 첫 호출은 ”%1" 로 교체되고 둘째 호출은 "%2” 로 교체된다 . 


setCaption(strippedName(curFile) + tr(" -Spreadsheet "))； 

와 같이 쓰는것이 더 좋지만 argO 를 사용하면 번역기에 유연성을 준다 . strippedNameO 에 의하 
여 파일의 경로를 삭제하고 파일이름을 사용자에게 편리하게 만든다 . 


파일이름이 있으면 응용프로그람의 최근에 연 파일목록인 recentFiles 를 갱신한다 . remove() 
를 호출하여 목록에서 파일이름을 삭제한 다음 pUS h_frcmt() 를 호출하여 파일이름을 첫 항목으 
로서 추가한다 . removeO 의 호출은 무엇보다 먼저 중복을 피하는데 필요하다 . 목록을 갱신한 
후에 비공개함수 updateRecentFilelternsQ 를 호출하여 File 차림표전부를 갱신한다 . 


recentPilelds 

recentPllelds 

recentPilelds 

recentPilelds 

recentPilelds 



- 구분선 


그림 3-11. 최근에 연 파일들이 있는 File 차림표 
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cenffiles 변수는 QStringList 형 (QS 仕 ing 의 목록 ) 이다 . 11 장에서 QStringList 와 같은 용기 클라스 
들과 C++ 표준형 판서 고 (STL) 와의 관계 를 자세 히 설 명 한다 . 

이리하여 File 차림표의 실현이 거의 완성되였다 . 아직 실현하지 못한 한개의 함수와 한개 
의 처 리 부가 남아있다 . 둘다 최 근에 연 파일목록의 관리 와 련관되 여있다 . 


void MainWindow: : updateRecentFileItems() 

I 

while ((int)recentFiles.size() > MaxRecentFiles) 
recentFiles.pop_back(); 

for (int i = 0; i < (int)recentFiles.size(); ++i) { 

QString text = tr("&%l %2").arg(i + l).arg(strippedName(recentFiles[i])); 
if (recentFileIds[i] == -1) { 
if (i == 0) 

fileMenu->insertSeparator(fileMenu->count() - 2); 
recentFileIds[i] = fileMenu->insertItem(text, this, SLOT(openRecentFile(int)), 
0, -1, fileMenu->count() - 2); 
fileMenu->setItemParameter(recentFilelds[i], i); 

} else { 

fileMenu->changeItem(recentFilelds[i ] ， text); 

} 



updateRecentFileltemsO 비공개함수는 최근에 연 파일들의 차림표항목을 갱신하기 위하여 
호출된다 . receirtFiles 목록에 허 용된것보다 항목이 많지 않는가 (MaxRecentFiles, mainwindow.h 에서 
5 로 정의되였다.：)를 확인하고 목록의 끝으로부터 남는 항목들을 삭제한다 . 

그다음 매개 항목들에 대하여 새로운 차림표항목을 창조하거나 혹은 존재하는 경우 현존 
항목을 재 리 용한다 . 차림 표항목을 처 음으로 창조할 때 또한 분리 선을 삽입한다 . 이 것을 
createMenusO 가 아니라 여기서 수행하여 한 행에 두개의 분리선을 절대로 현시하지 않도록 
한다 . setItemParameter() 호출을 간단히 설명 한다 . 

이것은 updateRecentFileItems() 에서 항목들을 창조하지만 절대로 항목들을 삭제하지 않는 
것처럼 보일수 있다 . 그것은 최근에 연 파일목록이 쎄손기간에 절대로 줄어들지 않는다고 가 
정할수 있기 때 문이 다 . 

QPopupMenu::insertItemO 함수는 아래와 같은 형식을 가진다 . 

fileMenu->insertItem(/ex/, receiver, slot, accelerator, id, index)-, 

text 는 차림표에 현시된 본문이다 . sttippedName() 을 사용하여 파일이름으로부터 경로를 삭 
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제한다 . 완전파일이름을 유지할수 있지만 그렇게 되면 File 차림표가 너무 길어지게 된다 . 완전 
한 파일차림표를 표시하려면 보조차림표에 최근에 연 파일들을 넣어야 한다 . 

receiver 와 5/of 파라메터 들은 사용자가 항목을 선택 할 때 호출되 여 야 할 처 리 부를 지 정 한다 . 
실례에서 는 MainWindow 의 openRecentFile(int) 처 리 부에 련결한다 . 

acce/erator 와 W 에는 차림표항목에 지름건이 없으며 자동적으로 생성된 ID 를 가진다는것 
을 의미하는 기정값들을 넘긴다 . 생성된 ID 를 recentFilelds 배렬에 보관하여 후에 항목들을 호 
출할수 있다 . 

index 는 항목을 삽입 하려 고 하는 위치 이다 . 값 fileMenu->count() -2 를 넘 김으로써 Exit 항목 
의 분리 선우에 그것 을 삽입한다 . 

void MainWindow: :openRecentFile(int param) 

{ 

if (maybeSave()) 

loadFile(recentFiles[param]); 

} 

openRecentFileO 처리 부는 많은곳에서 호출되는 처리 부이 다 . 이 처리 부는 File 차림표로부터 
최 근에 연 파일 이 선택될 때 호출된다 . int 파라메 터는 setItemParameter() 로 초기 에 설정 한 값이 
다 . recentFiles 목록에 대 한 첨 수로서 그것 들을 사용하는 방법 으로 값들을 선 택 하였다 . 

_ 안내항목들 초ᅵ근에 연 파일들 


ID text param 

-32 

ilab 公 4.sp 

0 

-33 2 sales 2001.sp 1 

-34 

2 Annual Report.sp 

2 

-35 

4 population.sp 

3 

-36 

5 Customers.sp 

4 


index 

value 

0 

A:\tab04.sp 

1 

C:\sales 2001.sp 

2 

D:\Annual Report.sp 

3 

C:\populalion.sp 

4 

C:\Customers.sp 


그림 3-12. 최근에 연 과일들의 관리 

이것은 문제를 해결하는 하나의 방법이다 . 이와 비숫한 다른 한가지 방법은 5 개의 작용을 
창조하여 5 개의 개별적인 처리부들에 련결하는것이다 . 

제4절. 상태띠의 설정 

차림표와 도구띠를 완성하였으므로 표계산프로그람의 상태띠를 작성할 준비가 되였다 . 표 
준상태에서 상태띠는 3 개의 지시자 (indicator) 즉 현재세포의 위치，현재세포의 식， MOD 로 이 
루어진다 . 또한 상태띠는 상태암시와 다른 림시통보문들을 현시하는데 쓰인다 . 

MainWindow 구성자는 createStatusBar() 를 호출하여 상태 띠를 설정 한다 . 
void MainWindow: : createStatusBar() 

{ 

locationLabel = new QLabel(" W999 ", this); 
locationLabel->setAlignment(AlignHC enter); 
locationLabel->setMinimumSize(locationLabel->sizeHint()); 
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formulaLabel = new QLabel(this); 
modLabel = new QLabel(tr( n MOD this); 
modLabel->setAlignment(AlignHCenter); 
modLabel->setMinimumSize(modLabel->sizeHint()); 
modLabel->clearO ； 

statusBar()->addWidget(locationLabel); 
statusBar()->addWidget(formulaLabel, 1); 
statusBar()->addWidget(modLabel); 

connect(spreadsheet, SIGNAL(currentChanged(int, int)), this, SLOT(updateCellIndicators())); 
connect(spreadsheet, SIGNAL(modified()), this, SLOT(spreadsheetModifiedO ))； 
updateCellIndicators(); 

} 

QMaitiWindow::statusBar() 함수는 상태띠의 지적자를 돌려준다.(상태띠는 statusBar() 가 처음 
으로 호출될 때 창조된다 .) 상태지시자는 필요할 때마다 본문이 변하는 QLabel 이다 . QLabel 들 
을 구성할 때 this 를 부모로서 넘 기 지만 QStatusBar :: addWidget() 가 그것들의 부모자식관계를 자 
동적으로 재설정하여 자식들을 만드므로 실제로 문제는 없다 . 

그림 3-13 은 3 개의 표식자가 각이한 공간요구를 가진다는것을 보여준다 . 세포위치와 
MOD 지시자들은 아주 작은 공간을 요구하고 창문의 크기가 조절될 때 여분의 공간은 중간의 
세포식 (formula) 이 차지하도록 한다 . 이 것은 QStatusBar :: addWidget() 호출에서 너 비곁수 1 을 지 
정하여 달성된다 . 다른 두개의 지시자들은 기정늘임곁수 0 을 가지는데 이것은 그것들의 크기 
가 변 하지 않는다것 을 의 미한다 . 

QStatusBar 가 지 시 자창문부품들을 배치할 때 QWidget::sizeHint() 에 의 해 주어 진 매개 창문 
부품의 리상적 인 크기를 고려하여 사용가능한 공간을 채우도록 창문부품들을 늘인다 . 창문부 
품의 리상크기는 창문부품의 내용에 따라 달라진다 . 위치와 MOD 지시자들의 크기가 끊임없이 
변하는것을 피하기 위하여 그것들의 최소크기를 매개 지시자에서 가능한 최대본문을 다 포함 
하는 폭 ("W999” 와 ’’MOD") 으로 설정한다 . 또한 그것들의 배치를 AlignHCenter 로 설정하여 본 
문이 수평으로 중심 에 놓이도록 한다 . 

l[~B4~|=A'-»-A2^/i3 |mOD 」 



삼태암시 

A 


일시 ■보문 

그림 3-13. 표계산프로그람의 상태띠 

함수의 끝부근에서 Spreadsheet 의 2 개 신호를 MainWindow 의 처 리부 updateCellIndicators() 
와 spreadsheetModifiedO 에 련결한다 . 
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void MainWindow: : updateCellIndicators() 

{ 

locationLabel->setText(spreadsheet->currentLocation()); 
formulaLabel->setText( M ’’ + spreadsheet->currentFormula()); 

} 

updateCellIndicator() 처 리 부는 세 포위 치 와 세 포식 지 시 자들을 갱 신 한다 . 이 것 은 사용자가 
세포유표를 새로운 세포로 이행할 때마다 호출된다 . 또한 그 처 리부는 createStatusBarO 의 끝에 
서 보통의 함수로 사용되여 지시자들을 초기화한다 . 이것은 Spreadsheet 가 기동시에 

currentChangedO 신호를 발생하지 않으므로 필요하다 . 
void MainWindow: : spreadsheetModified() 

{ 

modLabel->setText(tr("MOD ’’)) ; 
modified = true; 
updateCellIndicators(); 

} 

spreadsheetModifiedO 처리 부는 3 개의 지시자를 모두 갱신하여 사건의 현재상태를 반영하고 
변경 된 변수를 frue 로 설 정한다 . (File 차림 표를 실 현할 때 modified 변수를 사용하여 보관하지 않 
은 변경이 있는가 결정하였다 .:) 


제5절. 대화칸의 리용 

이 절에서는 (가에서 대화칸을 사용하는 방법 즉 대화칸을 창조하고 초기화하는 방법，그 
실 행 방법 , 사용자의 선택 에 응답하는 방법 을 설명한다 . 2 장에서 창조한 Find, Go-to-Cell, Sort 대 
화칸들을 사용할수 있게 한다 . 또한 단순한 About 칸도 창조한다 . 

우선 Find 대화칸부터 시작한다 . 사용자가 Spreadsheet 기본창문과 Find 대화칸을 마음대로 절 
환할수 있게 하려고 하므로 Find 대화칸은 이 행허용 (modeless) 대화칸이 여야 한다 . 이 행허용창문 
은 응용프로그람의 다른 창문들과는 독립적으로 실행되는 창문이다 . 

이행허용대화칸이 창조될 때 보통 사용자의 교제에 응답하는 처리부들에 련결된 자기의 
신호들을 가전다 . 

void MainWindow::find() 

{ 

if (IfindDialog) { 

findDialogj^new FindDialog(this); 

connect(findDialog, SIGNAL(findNext(const QString &, bool)), 
spreadsheet, SLOT(findNext(const QString &, bool))); 
connect(findDialog, SIGNAL(findPrev(const QString &, bool)), 
spreadsheet, SLOT(findPrev(const QS 仕 ing &, bool))); 
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} 

findDialog->show(); 
findDialog->raise(); 
findDialog->setActiveWindow(); 

} 

Find 대화칸은 표계산프로그람에서 사용자가 본문을 탐색할수 있게 하는 창문이다 . findO 처 
리부는 사용자가 Edit|Find 를 찰칵하여 Find 대화칸을 펼칠 때 호출된다 . 그 시점에서 여러가지 
경우가 있다 . 

•사용자가 처음으로 Find 대화칸을 펼친 경우 
•Find 대화칸을 그전에 펼쳤는데 사용자가 닫은 경우 
• Find 대화칸을 그전에 펼쳤는데 아직 표시 되 여있는 경 우 . 

Find 대화칸이 이미 존재하지 않으면 그것을 창조하고 그의 findNextO 와 findPrevO 신호를 
Spreadsheet 의 대응하는 처리부들에 련결한다 . 대화칸을 창조하지 않았다가 필요한 경우에 창 
조하면 프로그람의 기동을 빠르게 한다 . 또한 대화칸을 한번이라도 사용하지 않으면 절대로 
창조되지 않으며 이것은 시간과 기억기를 절약한다 . 

그다음 show(), raise(), setActiveWindowO 를 호출하여 창문을 다른것들의 우에 표시하고 능 
동창문이 되도록 한다 . show() 하나의 호출은 숨겨진 창문을 표시하는데 충분하며 Find 대화칸 
의 창문이 이 미 표시 되 여있을 때 호출되 는 경 우에 showO 는 아무 일도 하지 않는다 . 대화칸의 
창문을 이전의 상태와는 관계없이 꼭대기에서 볼수 있게 , 능동으로 만들어야 하므로 raiseO 와 
setActiveWindowO 를 호출해야 한다 . 다른 방법은 

if (findDialog->isHidden()) { 
findDialog->show() ; 

} else { 

findDialog->raise(); 
findDialog->setActiveWindow(); 

} 

라고 쓰는것이다 . 

다음으로 Go-to-Cell 대화칸을 고찰하자 . 사용자가 대화칸을 펼치고 그것을 리 용하며 
Go-to-Cell 대화칸으로부터 응용프로그람의 다른 창문으로 절환하지 않고 담으려고 한다 . 이것 
은 Go-to-Cell 대 화칸이 이 행 금지 창문이 라는것 을 의 미 한다 . 이 행 금지 (modal；) 창문은 기 동할 때 
창문이 펼쳐진 다음부터 닫길 때까지 응용프로그람의 다른 처리나 교제를 금지하는 창문이다 . 
Find 대화칸을 제외하고 지금까지 사용한 모든 대화칸은 이행금지대화칸이다 . 

대화칸이 show() 에 의해 펼쳐지면(미리 setModal() 를 호출하여 이행금지로 만들지 않으면 ) 
이 행허 용이 고 exec() 에 의 하여 펼쳐 지 면 이 행금지 이다 . 이 행 금지 대화칸을 exec() 에 의 해 기동 
할 때 일반적 으로 신호-처 리 부련결을 설정할 필요는 없다 . 
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void MainWindow::goToCell() 

{ 

GoToCellDialog dialog(this); 

if (dialog.execO) { 

QString s 仕 = dialog.lineEdit->text(); 

spreadsheet->setCurrentCell(str.mid( 1),toInt() -1, str[0] .upper().unicode() -'A'); 

} 

} 

QDialog::exec () 함수는 대화칸을 받아들이면 true, 그렇지 않으면 false 를 돌려준다 . (2 장에서 
Qt Designer 로 Go-to-Cell 대화칸을 창조할 때 OK 를 accept() 에 , Cancel 을 reject () 에 련결한것을 상 
기하시오 .) 사용자가 OK 를 찰칵하면 현재의 세포를 행편집기의 값으로 설정하고 사용자가 
Cancel 을 찰칵하면 exec () 는 false 를 돌려주고 아무 일도 하지 않는다 . 

QTable :: setCuirentCell () 함수는 2 개의 인수 즉 행번호와 렬번호를 요구한다 . 표계산프로그람 
에 서 세포 시은 cell (0, 0 ) 이 고 세 포 B27 은 cell (26, 1 ) 이 다 . QLabel :: text () 가 돌려 준 QStting 으로 
부터 행번호를 얻기 위해서는 QString :: midO (이것은 문자렬의 시작위치로부터 끝위치까지의 
부분문자렬을 돌려준다.:)에 의해 행번호를 엄고 QStting :: toInt () 에 의하여 그것을 int 로 변환하 
고 1 을 덜어서 0 으로부터 시작하는 셈의 행번호를 계산한다 . 렬번호에 대해서는 문자렬의 대 
문자화된 첫 문자의 수값에서 …의 수값을 던다 . 

Find 와 달리 Go-to-Cell 대화칸은 탄창에 창조된다 . 이행 금지 대화칸을 사용한 후에는 대화 
칸이 요구되 지 않으므로 이 것은 상황차림 표에서처 럼 이 행금지 대화칸의 일반적 인 프로그람작 
성 본보기 이 다 . 

다음으로 Sort 대화칸을 고찰한다 . Sort 대화칸은 현재 선택된 구역을 지정된 렬들에 따라 
사용자가 정렬하게 하는 이행금지대화칸이다 . 그림 3-14 는 1 차정렬마당으로서 렬 B, 2 차정렬마 
당으로서 렬 A 를 가지는 정 렬의 실례 이 다.(모두 자모순이다 .) 



그림 3-14. 표의 선택구역의 정렬 


void MainWindow :: sort() 

{ 
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SortDialog dialog ( 仕 lis); 

QTableSelection sel = spreadsheet->selection(); 

dialog.setColumnRange('A' + sel.leftCol(), ’A’ + sel.rightCol()); 

if (dialog.exec()) { 

SpreadsheetCompare compare; 

compare.keys[0] = dialog.primaryColumnCombo->currentItem(); 
compare.keys[l] = dialog.secondaryColumnCombo->currentItem() -1; 
compare.keys[2] = dialog.tertiaryColumnCombo->currentItem() -1; 
compare.ascending[Oj 체 (dialog.primaryOrderCombo->currentItem() =^. 務); 
compare.ascending[ 1] = (dialog.secondaryOrderCombo->currentItem()^^ 0); 
compare.ascending[2] = (dialog.tertiaryOrderCombo->currentItem() ==: U); 
spreadsheet->sort(compare); 

} 

} 

sortO 의 코드는 goToCellO 코드와 류사하다 . 

• 탄창에 대화칸을 창조하고 초기화한다 . 

• execG 에 의하여 대화칸을 펼친다 . 

•사용자가 OK 를 찰칵하면 대화칸의 창문부품들로부터 사용자가 입력한 값들을 꺼내서 
그것들을 사용하게 한다 . 

compare 객체는 1 차， 2 차， 3 차정렬마당들과 정렬순서를 보관한다 . (다음 장에서 
SpreadsheetCompare 클라스의 정의를 알게 된다 .) 이 객체는 Spreadsheet::sortO 가 두개 행을 비교 
하는데 사용된다 . keys 배렬은 마당들의 렬번호를 보관한다 . 례를 들면 선택이 C2 로부터 E5 로 
확장되면 렬 C 는 위치 0 을 가진 다 . ascending 배 렬은 매개 마당과 련관된 순서를 bo 이로서 보관 
한다 . QComboBox :: currentItemO 은 0 으로 시작하는 현재 선택된 항목의 첨수를 돌려준다 . 두번 
째와 세번째마당에는 None 항목으로부터 시작되므로 현재 항목으로부터 1 을 덜어야 한다 . 

sort() 대화칸은 동작하지 만 아주 빈 약하다 . 복합칸들과 None 항목들을 가지 고 일정 한 방법 
으로 Sort 대화칸을 실현한다 . 이것은 Sort 대화칸을 재설계한다면 이 코드를 다시 쓸 필요가 있 
다는것 을 의 미한다 . 이 수법 은 한곳에서 만 호출되 는 대 화칸에 적 합하지 만 대 화칸이 여 러 곳에 
서 사용된다면 관리하는데 불편하다 . 

더 좋은 방법은 SpreadsheetCompare 객체자체를 창조한 다음 그것을 호출자가 호출하게 하 
는것이다 . 이것은 MainWindow :: sortO 를 훨씬 단순하게 한다 . 

void MainWindow :: sort() 

{ 

SortDialog dialog(this); 

QTableSelection sel = spreadsheet->selection(); 
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dialog.setColumnRange('A' + sel.leftCol(), 'A' + sel.rightCol()); 
if (dialog.exec()) 

spreadsheet->perfonnSort(dialog.comparisonObject()); 

} 

이 수법은 부분품들을 원만히 결합시키며 여러곳에서 대화칸을 호출하는 경우에 흔히 사 
용된 다 . 

더 본질적인 수법은 SortDialog 객체를 초기화할 때 Spreadsheet 객체의 지적자를 넘기고 대 
화칸이 Spreadsheet 에서 직 접 조작하게 하는것 이 다 . 이 것은 SortDialog 가 일정 한 형 의 창문부품 
에 대해서만 작업하므로 일반적이지 못하지만 SortDialog :: setCol_RangeO 함수를 제거함으로 
써 코드를 혈씬 단순화한다 . 그때 MainWindow::sort () 함수는 다음과 같아진다 . 

void MainWindow: : sort() 

{ 

SortDialog dialog ( 仕 iis); 

dialog. setSpreadsheet(spreadsheet); 

dialog.exec(); 

} 

이 수법은 첫째 수법을 반영한다 . 대화칸에 대한 깊은 지식을 요구하는 호출자대신에 대 
화칸은 호출자에 의해 제공되는 자료구조에 대한 깊은 지식을 요구한다 . 이 수법은 대화칸을 
당장 변경해 야 할 필요가 있는 곳에서 사용할수 있다 . 그러 나 셋째 수법 은 자료구조가 변하 
면 파괴된다 . 

일부 개발자들은 대화칸을 사용하는 한가지 수법을 선택하며 그것만 사용한다 . 이것은 모 
든 대화칸사용이 같은 본보기를 따르므로 류사성과 단순성을 가지지만 사용하지 않은 수법들 
의 리득을 잃는다 . 어느 수법을 사용하겠는가 하는 론의는 매개 대화칸에 기초하여 이루어져 
야 한다 . 

끝으로 단순한 About 대화칸을 고찰한다 . Find 혹은 Go-to-Cell 대화칸와 같은 사용자정의 대 
화칸을 창조하여 판정 보를 표시할수 있지 만 대 부분의 About 칸들이 고도로 형 식 화되 므로 Qt 는 
더 단순한 해결책을 제공한다 . 

void MainWindow: : about() 

{ 

QMessageBox: : about(this, tr(”About Spreadsheet"), tr( M <h2>Spreadsheet 1.0</h2>" 
"<p>Copyright &copy; 2003 Software Inc." 
n <p>Spreadsheet is a small application that " 

"demonstrates <b>QAction</b>, <b>QMainWindow</b>, ’’ 

"<b>QMenuBar</b>, <b>QStatusBar</b>, ’’ 

"<b>QToolBar</b>，and many other Qt classes.")); 
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} 

About 대 화칸은 정 적 편의함수 QMessageBox::aboutO 를 호출하여 얻 는다 . 이 함수는 부모창 
문의 그림기호를 표준《경고》그림기호대신에 사용하는것을 제외하면 QMessageBox: : waming() 
와 아주 비슷하다 . 

1 혈 Spreadsheet 1.0 

Copyright <S» 2003 Software Inc. 

Spreadsheet is a small application that dem 〕 nstrat 的 

QAction, QMainWindow, QMenuBar, QStadusBar, 

QTodBar, and many other Qt classes. 

I QK I 


그림 3-15. About Spreadsheet 

지 금까지 는 QMessageBox 와 QFileDialog 로부터 여 러 개의 정 적편의함수들을 사용하였다 . 이 
함수들은 대화칸을 창조하고 초기화하며 그것에 대하여 exec () 를 호출한다 . 또한 좀 편리하지 
않지만 다른 창문부품처럼 QMessageBox 혹은 QFileDialog 창문부품을 창조하고 명시적으로 
exec () 를 호줄하거 나 지 어 표시 하는것 도 가능하다 . 

제6절. 환경설정의 보관 

MainWindow 구성 자에서 는 readSettingsO 를 호출하여 미 리 보관되 여있는 응용프로그람의 환 
경설정을 적재하였다 . 마찬가지로 closeEventQ 에서는 writeSettingsO 를 호출하여 환경설정을 보 
관하였다 . 이 두개의 함수는 MainWindow 에서 실현해야 할 마지막 성원함수들이다 . 

readSettings () 과 writeSettings () 의 모든 QSettings 관련코드와 함께 MainWindow 에서 선택한 
배렬은 수많은 가능한 수법들중의 하나이다 . 응용프로그람을 실행하는동안 임의의 시각에 코 
드의 임의의 위치에서 일부 설정을 질문하거나 수정하기 위하여 QSettings 객체를 창조할수 있 
다 . 


void MainWindow: : writeSettings() 

{ 

QSettings settings; 

settings-setPathCsoftware-incxom", "Spreadsheet"); 
settings.beginGroup( n /Spreadsheet"); 
settings.writeEntry("/geometry/x M , x()); 
settings.writeEntry("/geometry/y" ， y()); 
settings.writeEntry("/geometry/width", width()); 
settings.writeEntryC'/geometry/height", height()); 
settings.writeEntryCVrecentFiles", recentFiles); 
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settings.writeEntry(’’/showGrid”, showGridAct->isOn()); 
settings.writeEntryCVautoRecalc", showGridAct->isOn()); 
settings. endGroup(); 

} 

writeSettingsO 함수는 기본창문의 위치와 크기 , 최근에 연 파일들의 목록， Show Grid 와 
Auto-recalculate 선택들을 보관한다 . 

(^Settings 는 응용프로그람의 환경설정을 가동환경에 고유한 위치에 보관한다 . Windows 에서 
는 체계등록을 사용하고 Unix 에서는 본문파일에 자료를 보관하며 Mac OS 표에서는 Carbon 선 
택 API 를 사용한다 . setPathO 호출은 기 관의 이 름 (Internet 령 역 이 름 등)과 프로그람의 이 름을 가지 
는 (^Settings 을 제공한다 . 이 정보는 가동환경에 고유한 방법으로 환경설정의 위치를 찾는데 
사용된다 . 

(^Settings 는 환경설정을 마당-값쌍으로 보관한다 . 건은 파일체계경로와 비슷하고 늘 응용 
프로그람의 이름으로 시작하여야 한다 . 례를 들면 /Spreadsheet/geometry/x 와 

/Spreadsheet/showGrid 는 유효한 마당이다 . (beginGroup() 호출은 매개 마당의 앞에 /Spreadsheet 
를 써 넣 는데로부터 해방시 켜준다 .) 값은 하나의 int, bool, double, QString 혹은 QStringList 일수 
있 다 . 

void MainWindow: : readSettings() 

{ 

QSettings settings; 

settings.setPath(’’software-inc.com", "Spreadsheet"); 

settings.beginGroupCVSpreadsheet"); 

int x = settings.readNumEntry( n /geometry/x M , 200); 

int y = settings.readNumEntry( ,, /geometry/y ,, 5 200); 

int w = settings.readNumEntry( n /geometry/width M , 400); 

int h = settings.readNumEntry( M /geometry/height", 400); 

move(x,y); 

resize(w, h); 

recentFiles = settings.readListEntry( n /recentFiles n ); 
updateRecentFileItems(); 

showGridAct->setOn(settings.readBoolEntry( n /showGrid n , true)); 
autoRecalcAct->setOn(settings.readBoolEntry( ,, /autoRecalc n true)); 
settings. endGroup() ； 

} 

readSettings() 함수는 writeSettings() 에 의해 보관된 환경설정을 적재한다 . 읽기함수들에서 둘 
째 인수는 유효한 환경설정이 없는 경우에 기정값을 지정한다 . 기정값들은 응용프로그람을 
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처음으로 실행할 때 사용된다 . 

이로서 Spreadsheet 의 MainWindow 실현을 끝마친다 . 다음 절들에서 는 표계산프로그람을 수 
정 하여 여 러 문서 들을 취 급하는 방법 과 기 동화면을 실 현하는 방법 을 론의한다 . 다음 장에 서 
그 기능을 완성한다 . 


제7절. 여러 문서 

이 제는 표계산프로그람의 main() 함수코드를 작성 할 준비 가 되 였다 . 

#include <qapplication.h> 

#include "mainwindow.h" 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

MainWindow mainWin; 
app. setMainWidget(&mainWin); 
mainWin. show(); 
return app.exec(); 

} 

main() 함수는 지 금까지 작성 한것과 좀 다르다 . new 를 사용할 대신 에 탄창에 변수로서 
MainWindow 실례를 창조하였다 . 그때 MainWindow 실례는 함수가 완료할 때 자동적으로 해체 
된 다 . 

우에 보여준 ma i n () 함수에서 표계산프로그람은 하나의 기본창문을 제공하고 한번에 오직 
하나의 문서를 취급할수 있다 . 동시에 여러 문서를 편집하려고 한다면 표계산프로그람의 실 
례를 여러개 기동해야 한다 . 그러나 이것은 웨브열람기의 한개 실례가 동시에 여러개의 열람 
기창문을 제공하는것과 같이 여러개의 기본창문을 제공하는 응용프로그람의 하나의 실례를 
가지므로 사용자에게 편리하지 않다 . 

표계산프로그람을 수정하여 여러 문서를 취급할수 있게 할수 있다 . 우선 현저히 다른 
File 차림표가 필요하다 . 

• File|New 는 현재의 기본창문을 재리용할 대신에 빈 문서를 가지는 새로운 기본창문을 
창조한다 . 

- File|Close 는 현재의 기본창문을 닫는다 . 

• |Exit 는 모든 창문을 닫는다 . 

File 차림표의 원시판에서는 Close 선택이 Exit 와 갈으므로 없었다 . 

다음은 새 로운 mainO 함수이다 . 

#include <qapplication.h> 

#include "mainwindow.h” 
int main(int argc, char *argv[]) 
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{ 


QApplication app(argc, argv); 

MainWindow *mainWin = new MainWindow; 
mainWin->show(); 

QObject::connect(&app, SIGNAL(lastWindowClosed()), &app, SLOT(quit())); 
return app.exec(); 

} 


□ 

New 

Ctrl+N 

轉 

Open... 

Ctrl+O 

■ 

Save 

Ctri+S 


Save As... 



Close 

Ctrl+W 


EKit 

Ctrl+Q 


그림 3-16. 새로운 File 차림표 


QApplication 의 lastWindowClosed() 처리 부를 응용프로그람을 완료하는 QApplication 의 quit() 
처리부에 련결한다 . 

다중창문을 리 용할 때 new 로 MainWindow 를 창조하고 기본창문을 완료할 때 기억기를 절 
약하기 위하여 delete 를 사용하는것은 상식이다 . 이 문제는 응용프로그람이 하나의 기본창문만 
사용한다면 제기되지 않는다 . 

다음은 새로운 MainWindow::newFile() 처 리 부이 다 . 

void MainWindow: : newFile() 

{ 

MainWindow *mainWin = new MainWindow; 
mainWin->show(); 

} 

단순히 새로운 MainWindow 실례를 창조한다 . 새 창문의 지적자를 보관하지 않는것을 이상 
하게 생각할수 있으나 Qt 가 모든 창문들의 궤적을 보유하고있으므로 문제는 없다 . 

이것들은 C/ 에요와 표차 Y 용의 작용들이다 . 

closeAct = new QAction(tr("&Close"), tr( M Ctrl+W M ), this); 
connect(closeAct, SIGNAL(activated()), this, SLOT(close())); 
exitAct = new QAction(tr( M E&xit M ), tr( M Ctrl+Q M ), this); 
connect(exitAct, SIGNAL(activated()), qApp, SLOT(closeAllWindows())); 

QApplication 의 closeAllWindowsO 처리 부는 응용프로그람의 창문들중 하나가 close 사건을 거 
부하지 않으면 창문들을 모두 닫는다 . 이것은 정확히 여기서 요구하는 동작이다 . 창문을 닫을 
때마다 MainWindow::closeEvent() 에서 보관안된 변경을 처리한다 . 
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그것은 마치도 응용프로그람을 여러 창문을 조종할수 있게 만든것처럼 보인다 . 여기에는 
잠재하고있는 문제가 있다 . 즉 사용자가 기본창문의 창조와 닫기를 유지한다면 콤퓨터는 기 
억기부족을 일으킨다 . 이것은 newFileO 에서 MainWindow 창문부품들의 창조를 보관하고있으나 
결코 그것들을 삭제하지 않기때문이다 . 사용자가 기본창문을 닫을 때 기정동작은 그것을 은 
폐하는것이므로 아직도 기억기에 남아있다 . 수많은 기본창문이 있을 때 이것은 문제로 된다 . 

해결책은 WDestructiveClose 기발을 구성자에 추가하는것이다 . 

MainWindow::MainWindow(QWidget *parent, const char *name) 

: QMainWindow(parent, name, WDestructiveClose) { ... } 

이것은 Qt 에게 창문을 닫을 때 그것을 삭제 하라고 전 한다 . WDes 仕 uctiveClose 기발은 
QWidget 구성자에 넘기여 창문부품의 동작에 영향을 줄수 있는 수많은 기발들중의 하나이다 . 
다른 대부분의 기발은 Qt 응용프로그람들에서 드물게 요구된다 . 

기억기루실은 우리가 론의해야 할 유일한 문제가 아니다 . 원시적인 응용프로그람설계에는 
하나의 기본창문만 가질수 있다는 암시적인 가설을 포함하였다 . 여러개의 창문인 경우에 매 
개 기본창문은 자체의 최근에 연 파일목록과 자체의 선택들을 가지고있다 . 명백히 최근에 연 
파일목록은 전체 응용프로그람에 대하여 대역적이여야 한다 . recentFiles 변수를 정적변수로 선 
언하여 그의 유일한 한개 실례가 전체 응용프로그람에 존재하게 함으로써 이것을 아주 쉽게 
달성할수 있 다 . 그다음 File 차림 표를 갱 신하기 위 하여 updateRecentFileltemsO 를 호출하였 을 때 
마다 모든 기본창문에 대하여 그것을 호출할수 있도록 해야 한다 . 여기에 이것을 달성하기 
위한 코드가 있 다 . 

QWidgetList *list = QApplication: : topLevelWidgets(); 

QWidgetListlt it(*list); 

QWidget *widget; 

while ((widget = it.current())) { 

if (widget->inherits( M MainWindow M )) 

((MainWindow *)widget)->updateRecentFileItems(); 

++it; 

} 

delete list; 

코드는 응용프로그람의 제 일 웃준위창문부품들을 모두 순환하면서 MainWindow 형 의 모든 
창문부품들에 대하여 updateRecentFileItems() 를 호출한다 . 류사한 코드를 Show Grid 와 
Auto-recalculate 선택들을 동기 시 키는데 사용하거나 같은 파일을 두번 적재하지 않는다는것을 
확인하는데 사용할수 있다 . QWidge 仕 ist 형은 11 장 ( 용기클라스)에서 제시되는 QPtrList<QWidget> 
의 형정의 이 다 . 

기본창문마다 하나의 문서를 제공하는 응용프로그람들은 단일문서대면부응용프로그람이 
라고 말한다 . 또한 다중문서 대 면부를 가지 는 응용프로그람은 중심 구역 에서 여 러 개의 문서창 
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문들을 관리하는 하나의 기본창문을 가전다 . Qt 는 그것을 유지하는 모든 가동환경에서 SDI 와 
MDI 응용프로그람들을 둘다 창조하는데 사용될수 있다 . 그림 3-17 은 두가지 수법을 사용하는 
표계 산프로그람을 보여 준다 . MDI 는 6 장(배 치 관리 )에 서 설 명 한다 . 



그림 3-17. S 이와 MDI 

제8절. 기동화면 


수많은 응용프로그람들은 기동할 때 기동화면 (splash screen) 을 표시한다 . 일부 개발자들은 
기동화면에 의하여 느린 기동을 숨기고 다른 일부 개발자들은 사용자들의 요구를 만족시킨다 . 
QSplashScreen 클라스를 사용하여 Qt 응용프로그람에 기동화면을 간단히 추가할수 있다 . 

QSplashScreen 클라스는 응용프로그람이 적 당히 기 동되 기 전 에 화상을 표시 한다 . 또한 화 
상우에 통보문을 표시하여 사용자에게 응용프로그람의 초기화처리의 진척상황에 대하여 알릴 
수 있다 . 일반적으로 기동화면코드는 main() 에서 QApplication :: execO 에 대한 호출전에 배치된 
다 . 

다음은 기동시에 모듈들을 적재하고 망련결을 수립하는 응용프로그람에서 기동화면을 표 
시하는데 QSplashScreen 을 사용하는 main() 함수의 실례를 보여준다 . 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

QSplashScreen * splash = new QSplashScreen(QPixmap::fromMimeSource( ,, splash.png")); 
splash->show(); 

splash->message(QObject::tr("Setting up the main window..."), 

Qt::AlignRight | Qt::AlignTop, Qt::white); 



app.setMainWidget(&mainWin); 

splash->message(QObject::tr("Loading modules..."), Qt::AlignRight | Qt: : AlignTop,Qt: : white); 
loadModules(); 

splash->message(QObject::tr("Establishing connections..."), Qt::AlignRight | Qt::AlignTop, 
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Qt::white); 

establishConnections(); 
mainWin.show(); 
splash->finish(&mainWin); 
delete splash; 
return app.execQ; 



그림 3-18. QSplashScreen 창문부품 

이 리 하여 표계 산프로그람의 사용자대 면부를 완성하였 다 . 다음 장에 서 는 핵 심표계 산기능을 
실 현 함으로써 응용프로그람을 완성 한다 . 



제 4 장. 응용프로그람기능의 실현 

2 장과 3 장에서는 표계산프로그람의 사용자대면부를 창조하는 방법을 설명하였다 . 이 장에 
서는 그 기초로 되는 기능을 코드화하여 프로그람을 완성한다 . 그밖에 파일들을 적재하고 보 
관하는 방법，기 억기 에 자료를 보관하는 방법 , 오려둠판조작을 실현하는 방법 및 QTable 에 표 
계 산식 기 능을 추가하는 방법 을 설 명한다 . 

제1절. 중심창문부품 

QMainWindow 의 중심구역을 임의의 종류의 창문부품이 차지 할수 있다 . 여기서 그 가능성 
을 개괄한다 . 

① 표준 Qt 창문부품을 사용한다 . 

QTable 이 나 (^TextEdit 와 같은 표준창문부품을 중심창문부품으로 사용할수 있 다 . 이 경 우 
에 파일의 적재 및 보관과 같은 응용프로그람의 기능을 실현하여야 한다 . (례를 들면 
QMainWindow 파생 클라스에서 ) 

② 사용자정 의창문부품을 사용한다 . 

전 문화된 응용프로그람들은 흔히 사용자정 의창문부품에 자료를 표시하는것 이 필 요하다 . 
례를 들면 그림 기 호편집 프로그람은 그 중심창문부품으로서 IconEditor 창문부품을 가질수 있 
다乂 5 장에 서 는 어에 서 사용자정 의창문부품들을 작성 하는 방법 을 설 명한다 .:) 

③ 배치관리자를 가지는 일반 QWidget 를 사용한다 . 

흔히 응용프로그람의 중심 구역 은 수많은 창문부품들이 차지한다 . 이 것은 QWidget 를 다른 
모든 창문부품들의 부모로 사용하고 배치관리자에 의해 자식창문부품들의 크기와 위치를 설 
정함으로써 수행될수 있다 . 

④ 분할기를 사용한다 . 

여러 창문부품들을 함께 사용하는 다른 방법은 QSplitter 를 사용하는것이다 . QSplitter 는 자 
식창문부품들을 QHBox 와 같이 한행 에，혹은 QVBox 와 같이 한렬 에 배 렬 하며 분할기 를 사용 
하여 사용자가 크기를 조절할수 있게 한다 . 분할기 (splitter) 는 다른 분할기를 비롯한 모든 종류 
의 창문부품들을 포함할수 있다 . 

⑤ MDI 작업공간을 사용한다 . 

응용프로그람이 MDI 를 사용하면 중심구역은 QWorkspace 창문부품이 차지하고 매개의 
MDI 창문은 그 창문부품의 자식으로 된다 . 

배치관리자，분할기 , MDI 작업공간들은 표준 Qt 창문부품들 혹은 사용자정의창문부품들과 결 
합되 여 쓰일수 있다 .(6 장에서 이 클라스들을 자세 히 설 명한다 .：) 

표계 산프로그람에 서 QTable 의 파생 클라스는 중심 창문부품으로 사용된 다 . QTable 클라스는 
이미 요구되는 표계산기능의 대부분을 제공하지만 =A1+A2+A3 과 같은 표계산식을 리해하지 
못하며 오려둠판조작을 유지하지 못한다 . 그러므로 QTable 로부터 계승하는 Spreadsheet 클라스 
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에서 빠뜨린 기능을 실현한다 


제2절. QTable 의 파생클라스만들기 

그러면 머리부파일로부터 Spreadsheet 창문부품의 실현을 시작하자 . 

#ifndef SPREADSHEET^ 

#define SPREADSHEET^ 

#include <qstringlist.h> 

#include <qtable.h> 
class Cell; 

class SpreadsheetCompare; 

머리부파일은 Cell 과 SpreadsheetCompare 클라스들의 앞방향선언들로 시작한다 . 

Qt 

_I_ 

I I 

OUbjecI QTableltem 
I I 

Q Widget Cell 

QTable 

I 

Spreadsheet 

그림 4-1. Spreadsheet 과 Cell 의 계 승나무 

본문과 배치 등 QTable 세포의 속성들은 QTableltem 에 보관된다 . QTable 와 달리 QTableltem 
은 창문부품클라스가 아니 고 순수한 자료클라스이 다 . Cell 클라스는 QTableltem 파생 클라스이 다 . 
표준 QTableltem 속성들과 함께 Cell 은 세포식을 보관한다 . 

이 장의 마지막 절에서 Cell 클라스실현을 제시할 때 설명한다 . 
class Spreadsheet : public QTable 
{ 

Q_OBJECT 

public: 

Spreadsheet(QWidget ^parent = 0， const char *name = 0); 
void clear(); 

QString currentLocation() const; 

QString currentFormula() const; 
bool autoRecalculate() const { return autoRecalc; } 
bool readFile(const QString &fileName); 
bool writeFile(const QString &fileName); 

QTableSelection selection(); 

void sort(const SpreadsheetCompare &compare); 
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Spreadsheet 클라스는 QTable 을 계승한다 . QTable 의 파생클라스작성은 QDialog 혹은 

QMainWindow 의 파생클라스작성과 아주 비숫하다 . 

3 장에서는 MainWindow 를 실현할 때 Spreadsheet 의 수많은 공개함수들에 기초하였다 . 례를 
들면 MainWindow::newFile() 로부터 clear() 를 호출하여 표계산프로그람을 재설정하였다 . 또한 
QTable 로부터 계승된 함수들 특히 setCurrentCellO 과 setShowGrid() 를 리용하였다 . 
public slots: 
void cut(); 
void copy(); 
void paste(); 
void del(); 
void selectRow(); 
void selectColumn(); 
void selectAll(); 
void recalculate(); 
void setAutoRecalculate(bool on); 
void findNext(const QString &str, bool caseSensitive); 
void findPrev(const QString &str, bool caseSensitive); 



void modified(); 

Spreadsheet 는 Edit, Tools, Options 차림표로부터 작용들을 실현하는 수많은 처 리 부를 제공한 
다 . 

protected: 

QWidget *createEditor(int row, int col, bool initFromCell) const; 
void endEdit(int row, int col, bool accepted, bool wasReplacing); 

Spreadsheet 는 QTable 로부터 2 개의 가상함수를 재정의한다 . 이 함수들은 사용자가 세포의 
값편집을 시작할 때 QTable 자체에 의해 호출된다 . 그것들을 재정의하여 표계산식들을 유지해 
야 한다 . 



enum { MagicNumber = 0x7F51C882, NumRows = 999, NumCols = 26 }; 
Cell *cell(int row, int col) const; 

void setFormula(int row, int col, const QString &formula); 

QString formula(int row, int col) const; 
void somethingChanged(); 
bool autoRecalc; 


}； 
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클라스의 비 공개 절 에서 는 3 개의 상수， 4 개의 함수，하나의 변수를 정 의 한다 . 
class SpreadsheetCompare 
{ 

public: 

bool operator()(const QStringList &rowl, const QStringList &row2) const; 
enum { NumKeys = 3 }; 
int keys [NumKeys]; 
bool ascending[NumKeys]; 

}； 

#endif 

머리부파일은 SpreadsheetCompare 클라스선언으로 끝난다 . Spreadsheet::sort () 를 고찰할 때 이 
것을 설명한다 . 

이제는 매개 함수를 차례로 설명하면서 실현부분을 고찰한다 . 

#include <qapplication.h> 

#include <qclipboard.h> 

#include <qdatastream.h> 

#include <qfile.h> 

#include <qlineedit.h> 

#include <qmessagebox.h> 

#include <qregexp.h> 

#include <qvariant.h> 

#include 〈 algorithm 〉 

#include <vector> 
using namespace std; 

#include "cell.h" 

#include "spreadsheet 上 ’’ 

응용프로그람이 사용하는 Qt 클라스들의 머리부파일들을 포함한다 . 또한 표준 C ++ 의 
<algorithm > 과 <vector > 머리 부파일을 포함한다 . using 이름공간지령은 std 이름공간으로부터 대역 
이름공간으로 모든 기호들을 반입하여 std::stable_sort () 와 std::vectoKT > 대신에 stable_sort () 와 
¥ 〜 1 ： 01<1 >를 쓸수 있게 한다 . 

Spreadsheet: : Spreadsheet(QWidget ^parent, const char *name) : QTable(parent, name) 


autoRecalc = true; 

setSelectionMode(Single); 

clear(); 







} 

구성자에서는 QTable 선택방식을 Single 로 설정한다 . 이것은 Spreadsheet 에서 한번에 오직 
하나의 직 4 각형구역을 선택할수 있도록 한다 . 
void Spreadsheet: : clear() 

{ 

setNumRows(O); 

setNumCols(O); 

setNumRows(NumRows); 

setNumCols(NumCols); 

for (int i = 0; i < NumCols; i++) 

horizontalHeader()->setLabel(i, QChar(’A’ + i)); 
setCurrentCell(0, 0); 

} 

clear () 함수는 Spreadsheet 구성자로부터 호출되여 작업표를 초기화한다 . 또한 MainWindow:: 
newFileO 로부터도 호출된다 . 

표를 0x0 크기로 조절하여 전체 표를 효과적으로 삭제하고 다시 표를 NumColsxNumRows 
(26x999 ) 크기로 조절한다 . 렬표식들을 A, B, ... ， Z (기 정은 1,2, ... ， 26 ) 로 변경하고 세포유표를 세 
포 시로 옳긴다 . 



그림 4-2.QTable 의 구성 창문부품들 


QTable 은 많은 자식창문부품들로 구성 된 다 . 웃끝에 수평 QHeader ， 왼 쪽에 수직 QHeader, 오 
른쪽에 QScrollBar, 그리고 밑에 QScrollBar 를 가진다 . 중심구역은 QTable 이 세포들을 그리는 
보기 구역 (viewport ) 이 라고 부르는 특수한 창문부품이 차지 한다 . 각이 한 자식 창문부품들은 
QTable 과 그 기초클라스 , QScrollView 의 함수들을 통하여 호출할수 있다 . 례를 들면 clearQ 에서 
는 QTable:: horizontalHeaderO 를 통하여 표의 웃끝에 있는 QHeader 를 호출할수 있다 . 

항목으로서 자료를 보관하기 

표계산프로그람에서 비지 않은 매개 세포는 개별적인 QTableltem 객체로 기억기에 보관 
된 다 . 자료를 항목들로 보관하는 이 견본은 QTable 에 고유한것이 아니고 Qt 의 QIconYiew, 
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QListBox, QListView 클라스들도 항목 (QIconViewItem ， QListBoxItem, QListViewItem ) 들에 대하여 
조작한다 . 

Qt 의 항목클라스들은 칸의 밖에서 자료소유자로서 사용될수 있다 . 례를 들면 QTableltem 
은 이미 문자렬，픽스매프， QTable 에로의 역지 적자를 비롯하여 여 러 가지 속성들을 보관한다 . 
항목클라스를 파생클라스로 만들어 추가자료를 보관하고 그 자료를 사용하는 가상함수들을 
재정의 한다 . 

수많은 도구묶음들은 항목클라스들에 void 지 적 자를 제 공하여 사용자정 의 자료를 보관한 
다 . Qt 는 사용할수 없는 지적자로 인하여 매개 항목에 부담을 지우지 않고 그대신에 프로그 
람작성자들이 자유로 항목클라스들의 파생클라스를 작성하고 될수록 다른 자료구조의 지적 
자로서 거기에 자료를 보관하게 한다 . void 지적자가 요구되면 항목클라스의 파생클라스를 만 
들고 void 지적자성원변수를 추가하여 얻을수 있다 . 

QTable 에서 paintCell () 과 clearCell () 과 같은 저수준함수들을 재정의하여 항목기구를 넘길 
수 있다 . QTable 에서 표시하려는 자료가 이미 기억기에 다른 자료구조로 있으면 이 수법은 

자료중복을 피하는데 사용할수 있다 . _ 

QScrollView 는 수많은 자료를 제시할수 있는 창문부품의 기 초클라스이 다 . 이 것은 흘림 가 
능한 보기구역과 on/off 할수 있는 2 개의 흘림띠를 제공한다.(이것은 6 장에서 설명한다 .：) 

Cell * Spreadsheet :: cell(int row, int col) const 

{ 

return (Cell *)item(row, col); 

} 

cell () 비공개함수는 주어진 행과 렬의 Cell 객체를 돌려준다 . 이것은 QTableltem 지적자대신에 
Cell 지적자를 돌려주는것을 제외하면 QTable::item () 과 거의 같다 . 

QString Spreadsheet::formula(int row, int col) const 

{ 

Cell *c = cell(row, col); 
if (c) 

return c->formula(); 

else 


} 

fomulaO 비공개 함수는 주어진 세포의 식을 돌려 준다 . cell () 이 null 지적 자를 돌려 주면 세포 
는 비 여있으므로 빈 문자렬을 돌려 준다 . 

void Spreadsheet: : setFormula(int row, int col, const QString &formula) 

{ 


Cell *g. « cell(row, col); 
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if (c) { 

c->setFormula(formula); 

updateCell(row, col); 

} else { 

setItem(row, col, new Cell (this, formula)); 

} 

} 

sefformulaO 비공개 함수는 주어진 세포의 식을 설정 한다 . 세포가 이미 Cell 객체를 가지고있 
으면 그것을 재리용하며 updateCell () 를 호출하여 QTable 의 세포가 화면에 있으면 세포를 다시 
그리게 한다 . 그렇지 않으면 새로운 Cell 객체를 창조하고 QTable::setltem () 을 호출하여 그것을 
표에 삽입하고 세포를 다시 그린다 . 후에 Cell 객체를 삭제할 때 QTable 은 세포의 소유권을 가 
지며 정확한 시각에 자동적으로 그것을 삭제한다 . 

QString Spreadsheet::currentLocation() const 

{ 

return QChar('A' + currentColumn()) + QString::number(currentRow() + 1); 

} 

curre 付 Location () 함수는 행번호뒤에 렬문자가 오는 보통의 표계산형식으로 현재세포의 위 
치를 돌려준다 . MainWindow::updateCellIndicatorsO 는 그것을 사용하여 상태띠 에 위치 를 표시 한 
다 . 

QString Spreadsheet::currentFonnula() const 

return formula(currentRow(), currentColumn()); 

} 

currentFormulaO 함수는 현재세포의 식을 돌려준다 . 이것은 MainWindow::updateCellIndicators 
0 로부터 호출된다 . 

QWidget * Spreadsheet: : createEditor(int row, int col, bool initFromCell) const 

{ 

QLineEdit *lineEdit = new QLineEdit(viewport()); 
lineEdit->se 任 7 rame(false); 
if (initFromCell) 

lineEdit->setText(formula(row, col)); 
return lineEdit; 

} 

createEditor () 함수는 QTable 로부터 재정의된다 . 이 함수는 사용자가 세포의 편집을 시작할 
때 즉 세포를 찰칵하고 厂 2 을 누르거나 단지 입력을 시작할 때 호출된다 . 그의 역할은 세포의 





꼭대기 에 표시 하려는 편집 기 창문부품을 창조하는것 이 다 . 사용자가 세포를 편집 하기 위 하여 
세포를 찰칵하거나 F2 을 누르면 initFromCell 가 true 로 되고 편집기는 현재세포의 내용으로 시 
작해야 한다 . 사용자가 단순히 입력을 시작하면 세포의 이전 내용은 무시된다 . 

이 함수의 기정동작은 QLineEdit 를 창조하고 iniffromCell 가 ttue 이면 행편집기를 세포의 
본문으로 초기 화하는것 이 다 . 세포의 본문대신에 세포의 식 을 표시 하도록 함수를 재정 의한다 . 

QLineEdit 을 QTable 의 보기구역의 자식으로 창조한다 . QTable 은 세포의 크기와 일치하도록 
QLineEdit 의 크기를 조절하는것과 편집 하려는 세포우에 그것 이 놓이도록 한다 . 또한 QTable 은 
QLineEdit 가 더는 필요하지 않을 때에는 그것을 삭제한다 . 

많은 경우에 식과 본문은 갈다 . 례를 들면 식 Hello 는 문자렬 "Hello" 로 평가되므로 사용 
자가 세 포에 ’’Hello’’ 를 입 력 하고 Enter 를 누르면 그 세 포는 본문 ’’Hello" 를 표시 한다 . 그러 나 
례외가 있다 . 

1 iF| m L 쎄 — 1 

Cell QLineEdit 

그림 4-3. QLineEdit 를 첨 부한 세 포의 편집 

• 식 이 수이면 수로 해석한다 . 례를 들면 식 1.50 은 double 값 1.5 로 평가되고 표에 오른쪽 
으로 채워넣 은 "1.5” 로 표시 된다 . 

• 식이 단일인용표로 시작되면 식의 나머지는 본문으로 해석된다 . 례를 들면 식 "12345 은 
문자렬 "12345" 로 평가한다 . 

• 식이 같기기호(여로 시작되면 식은 산수식으로 해석된다 . 례를 들면 세포 A1 에 12 이 있 
고 세포 A2 이 6 을 포함하면 식 =A1+A2 은 18 로 평 가된다 . 

식을 값으로 변환하는 일은 Cell 클라스가 수행한다 . 여기서 명심해 야 할 중요한것은 세포 
에 표시된 본문이 식자체가 아니라 식을 평가한 결과라는것이다 . 

void Spreadsheet: : endEdit(int row, int col, bool accepted, bool wasReplacing) 

{ 

QLineEdit *lineEdit = (QLineEdit *)cellWidget(row, col); 

if (IlineEdit) 
return; 

QString oldFormula = formula(row, col); 

QString newFormula = lineEdit->text(); 

QTable :: endEdit(row, col, false, wasReplacing); 

if (accepted && newFormula != oldFormula) { 
setFormula(row, col, newFormula); 



} 
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endEditO 함수는 QTable 로부터 재정의된다 . 이것은 사용자가 표안의 임의의 곳을 선택하고 
Enter 건을 누르거나 Esc 건을 눌러서 세포의 편집을 끝냈을 때 호출된다 . 함수의 목적은 편집 
이 확인되면 편집기의 내용을 Cell 객체로 전송하는것이다 . 

편집기는 QTable::cellWidget() 로부터 사용할수 있다 . createEditor() 에서 창조하는 창문부품이 
항상 QLineEdit 이므로 편집기를 안전하게 QLineEdit 로 강제변환할수 있다 . 

| = AUA 2[ 1 _ | 18] 

QLineEdit Cell 

그림 4-4. QLineEdit 의 내 용을 세 포에 돌려 주기 
함수의 중간에서는 QTable 이 편집의 완료를 알아야 하므로 QTable 의 endEdit() 실현을 호출 
한다 . endEdit() 의 셋째 인수로서 false 를 넘기여 표항목의 변경을 방지한다 . 그것은 우리가 자 
체 로 표항목을 창조하거 나 변 경 하려 고 하기때 문이 다 . 새 로운 식 이 이 전 식 과 다르면 
setFomiula() 를 호출하여 Cell 객체를 수정하고 somethingChanged() 를 호출한다 . 
void Spreadsheet :: somethingChanged() 

{ 

if (autoRecalc) 
recalculate(); 
emit modified(); 

} 

somethingChanged() 비공개 함수는 Auto-recalculate 이 허용되면 전체 표를 다시 계산하고 

modifiedO 신호를 발생한다 . 

제3절. 적재와 보관 

여기서는 사용자정의 2 진형식을 리용하는 Spreadsheet 파일들의 적재와 보관을 실현한다 . 가 
동환경에 의존하지 않는 2 진입출력을 제공하는 QFile 과 QDataStream 을 리용하여 이것을 수행 
한다 . 

우선 Spreadsheet 파일을 써넣는다 . 

bool Spreadsheet: : writeFile(const QString &fileName) 

{ 

QFile file(fileName); 

if (!file.open(IO WriteOnly)) { 

QMessageBox: : waming(this, tr("Spreadsheet n ), 

tr("Cannot write file %l:\n%2. M ).arg(file.name()).arg(file.errorString())); 
return false; 

} 

QDataStream out(&file); 

out.setVersion(5); 
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out «(Q_UINT32) MagicNumber; 

QApplication::setOverrideCursor(waitCursor); 
for (int row = 0; row < NumRows; ++row) { 
for (int col = 0; col > NumCols; ++col) { 

QString str = formula(row, col); 
if (!str.isEmpty()) 

out « (Q_UINT16)row « (Q_UINT16)col « str; 

} 

} 

QApplication::restoreOverrideCursor(); 
return true; 

} 

writeFile () 함수는 MainWindow::saveFile () 로부터 호출되며 파일을 디스크에 써넣는다 . 이 함 
수는 성공하면 true, 오유이면 false 를 돌려준다 . 

주어진 파일이름으로 QFile 객체를 창조하고 openO 을 호출하여 써넣으려는 파일을 연다 . 
또한 QFile 에 조작하는 QDataStream 객체를 창조하고 그것을 사용하여 자료를 써넣는다 . 자료 
를 써넣기전에 응용프로그람의 유표를 표준기다림유표(보통 모래시계)로 변경하고 자료를 모 
두 써넣은 다음에는 표준유표를 되살린다 . 함수의 끝에서 파일은 자동적으로 QFile 의 해체자 
에 의해 닫겨 진 다 . 

QDataStteam 은 표준 C ++ 자료형들과 함께 대부분의 Qt 자료형들을 제공한다 . 문법은 표준 
<iostream > 클라스들과 같다 . 례를 들면 
out « x « y « z; 

은 변수 x ， y,z 를 흐름에 써넣으며 
in » x » y » z; 

은 흐름으로부터 그것들을 읽어들인다 . 

C++ 기 본형 char, short, int, long, long long 이 각이 한 가동환경 에 서 각이 한 크기 를 가질수 있 
오므로 이 값들을 Q INT8, Q_UINT8, Q INT16, Q_UINT16, Q INT32, Q_UINT32, Q_INT64, 
Q_UINT64 중 하나로 강제변환하는것이 보다 안전하다 . 

QDataStream 은 아주 만능적 이 다 . 이 것은 QFile 뿐아니 라 QBuffer, QSocket, 혹은 
QSocketDevice 에도 쓰일수 있 다 . 마찬가지로 QFile 은 QDataStream 대신에 QTextStream 에서 쓰일 
수도 있다 .(10 장에서 이 클라스들을 자세히 설명한다 .) 

표계산프로그람의 파일형식은 아주 간단하다 . Spreadsheet 파일은 파일형식을 식별하는 
32bit 수 (MagicNumber, spreadsheeth 에서 0x7F51C882 로 정의된다.)로 시 작된다 . 그다음 일련의 블 
로크들이 온다 . 매개 블로크는 한개 세포의 행，렬，식을 포함한다 . 공간을 절약하기 위하여 
빈 세포들은 써넣지 않는다 . 
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그림 4-5. Spreadsheet 파일 형 식 

자료형의 정확한 2 진형식은 QDataStream 에 의해 결정된다 . 례를 들면 Q_IHNT16 는 비그엔 
디안순서로 2byte 로 표시되고 QS 仕 ing 은 문자렬의 길이와 그뒤에 오는 유니코드문자들로 표시 
된 다 . 

Qt 형들의 2 진표시는 Qt 1.0 이후 아주 많이 진화되였다 . 이것은 현존형들의 진화와 보조를 
맞추고 새로운 어형 들을 허 용하면서 앞으로의 Qt 출하물들에서 계속 진화되 여나갈것 이 다 . 기 
정 으로 QDataStream 은 가장 최 근판의 2 진 형 식 災 t 3.2 에 서 5 판)을 리 용하지 만 낡은 판을 읽 어 들 
일수 있게 설정된다 . 호환성문제를 피하기 위하여 응용프로그람을 새로운 Qt 출하판을 리용하 
여 후에 재를파일한다면 를파일하고있는 Qt 의 판에 관계없이 QDataStream 이 5 판을 사용하게 
한다 . 

bool Spreadsheet: : readFile(const QString &fileName) 

{ 

QFile file(fileName); 

if (!file.open(IO ReadOnly)) { 

QMessageBox: : waming(this, tr("Spreadsheet"), tr("Caimot read file %l:\n%2. M ) 

. arg(file .name()). arg(file .errorString())); 
return false; 

} 

QDataStream in(&file); 
in.setVersion(5); 

Q—UINT32 magic; 
in » magic; 

if (magic != MagicNumber) { 

QMessageBox: : waming(this, tr("Spreadsheet"), tr("The file is not a Spreadsheet file.")); 
return false; 

} 

clear(); 

Q_UINT16 row; 

Q_UINT16 col; 

QString str; 

Q Application: : setO verrideCursor(waitCursor); 
while (!in.atEnd()) { 

in » row » col » str; 
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setFormula(row, col, str); 


} 

QApplication::restoreOverrideCursor(); 
return true; 

} 

readFileO 함수는 writeFileO 과 거의 비숫하다 . QFile 에 의하여 파일을 읽 어들이지만 이 번에 
는 IO_WriteOnly 가 아니라 IO_ReadOnly 기발을 사용한다 . 그다음 QDataStream 판을 5 로 설정한 
다 . 읽으러는 형식은 늘 써넣는 형식과 같아야 한다 . 

파일이 선두에 정확한 식별번호를 가지고있다면 clearO 를 호출하여 표의 모든 세포들을 
비우고 세포자료를 읽 어들인다 . clear 。 호출은 파일에서 지 정되지 않은 세포들을 비우는데 필요 
하다 . 


제4절. Edit 차림표의 실현 

응용프로그람의 Edit 차림표에 대응하는 처리부들을 실현할 준비가 되 였다 . 
void Spreadsheet: :cut() 

{ 

copy(); 

del(); 

} 

cut () 처리부는 Edit|Cut 에 대응된다 . Cut 의 실현은 먼저 Copy 를 , 다음으로 Delete 를 호출하는 
것으로 실현할수 있다 . 


1 Edit 

然 Cut 

Ctrl+X 


[3 £°py 

Ctrl+C 


Qb 

Ctrl+V 


총총 Delete 

Del 


Select 

► 

Rost 

名한 Bnd... 

Ctrl+F 

Cokmn 

^ goto Cell... 

F5 _ 

A|l Ctrl+A 

J 


그림 4-6. 표계산프로그람의 Edit 차림표 


void Spreadsheet: : copy() 

{ 

QTableSelection sel = selection(); 
QString str; 


for (int i = 0; i < sel.numRows(); ++i) { 
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if (i > 0) 
str += "\n"; 

for (int j = 0; j < sel.numCols(); ++j) { 
if (j > 0) 

str ， ‘ , ， \t"; 

str += formula(sel.topRow() + i, sel.leftCol() + j )； 

} 

} 

QApplication::clipboard()->setText(str); 

} 

copyO 처리부는 Edit|Copy 에 대응된다 . 이 함수는 현재선택세포들을 순환한다 . 선택된 매개 
세 포의 식 은 QStting 에 추가된 다 . 이 때 행 들은 행 바꾸기 문자에 의해 구분되 고 렬들은 타브문 
자에 의해 구분된다 . 



■ 
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그림 4 - 7 . 선택내용을 오려둠판에 복사하기 

체계오려둠판은 (^Application::clipboard() 정적함수를 통하여 (겨에서 사용할수 있다 . 이 응용 
프로그람과 평본문을 취급하는 다른 응용프로그람들에서 QClipboard :: setTextO 를 호출하여 오 
려둠판에 본문을 보관할수 한다 . Microsoft Excel 을 비롯한 여 러가지 응용프로그람들에서 분리 
기호로서 타브와 행바꾸기문자를 리용한다 . 

QTableSelection Spreadsheet::selection() 

{ 

if (QTable::selection(0).isEmpty()) 

return QTableSelection(currentRow(), currentColumn(), currentRow(), currentColumn()); 
return QTable :: selection(O); 

} 

selectionO 비공개함수는 현재선택구역을 돌려준다 . 이 함수는 선택구역을 수값으로 돌려주 
는 QTable :: selection() 에 의존한다 . 선택 방식을 Single 로 설정 하였으므로 0 이라는 번호를 가지는 
유일한 하나의 선택구역만이 있다 . 그러나 선택구역이 전혀 없을수도 있다 . 이것은 QTable 이 
자체로 현재세포를 선택구역으로 취급하지 못하기때문이다 . 이 동작은 타당하지만 여기서는 
아주 불편하므로 현재선택을 돌려주거나 선택이 없으면 현재세포를 돌려주는 selectionO 함수 
를 실현한다 . 
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void Spreadsheet: : paste() 

{ 

QTableSelection sel = selection(); 

QString str = QApplication::clipboard()->text(); 

QStringList rows = QStringList::split( M \n M , str, true); 

int numRows = rows.size(); 

int numCols = rows.first().contains( M \t n ) + 1; 

if (sel.numRows() * sel.numCols() != 1 && (sel.numRows() != numRows 
|| sel.numCols() != numCols)) { 

QMessageBox: : information(this, tr( n Spreadsheet"), tr("The information cannot be " 
’’pasted because the copy and paste areas aren't the same size.’’)); 
return; 

} 

for (int i = 0; i < numRows; ++i) { 

QStringList cols = QStringList::split(’’\t", rows[i], true); 
for (int j = 0; j < numCols; ++j) { 
int row = sel.topRow() + i; 
int col = sel.leftCol() + j; 
if (row < NumRows && col < NumCols) 
setFormula(row, col, cols[j]); 

} 

} 

somethingChanged(); 

} 

paste() 처 리 부는 Edit|Paste 에 대 응한다 . 본문을 오려 둠판에 끌어 오고 정 적 함수 
QStringList::split() 를 호출하여 문자렬을 QS 仕 ingList 에 보관한다 . 매개 행은 QS 仕 ingList 의 한개 
문자렬로 된다 . 

다음에 복사구역 의 치 수를 결 정한다 . 행 수는 QS 仕 ingList 안의 문자렬 수이 고 렬 수는 첫 행 
안의 타브문자수에 1 을 더한 값이 다 . 

오직 하나의 세포가 선택되면 그 세포를 붙이기구역의 왼쪽웃구석으로 사용한다 . 그렇지 
않으면 현재선택을 붙이기구역으로 사용한다 . 

붙이기를 진행하기 위하여 행들을 순환하면서 QStringList::split(} 를 다시 사용한다 . 이번에 
는 타브를 분리 기 호로 사용하여 매 행 을 세 포들로 분할한다 . 그림 4-8 은 그 단계 를 설 명한다 . 
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그림 4-8. 오려 둠판본문을 표계 산프로그람에 붙이 기 
void Spreadsheet: :del() 

{ 

QTableSelection sel = selection(); 
for (int i = 0; i < sel.numRows(); ++i) { 
for (int j = 0; j < sel.numCols(); ++j) 

delete cell(sel.topRow() + i, sel.leftCol() + j); 

} 

clearSelection(); 

} 

del() 처 리 부는 Editpelete 에 대 응한다 . 세 포들을 삭제 하기 위 하여 선 택안의 Cell 객 체 들에 대 
하여 delete 를 리용하면 충분하다 . QTable 은 QTableltem 들이 삭제될 때 통지하며 자동적으로 자 
체를 다시 그린다 . 삭제한 세포의 위치를 넘기여 cellG 을 호출하면 함수는 null 지적자를 돌려 
준다 . 

void Spreadsheet: : selectRow() 

{ 

clearSelection(); 

QTable: :selectRow(currentRow()); 

} 

void Spreadsheet: : selectColumn() 

{ 

clearSelection(); 

QTable: : selectColumn(currentColumn()); 

} 

void Spreadsheet: : selectAll() 

{ 


clearSelectionQ; 
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selectCells(0, 0, NumRows - 1， NumCols 一 1); 


} 

selectRow(), selectColumn(), selectAll () 함수들은 각각 Edit|Select|Row, Edit|Select|Column, Edit| 
Select|All 차림표들에 대응된다 . 그 실현은 QTable 의 selectRow(), selectColumn(), selectCells () 함수 
들에 기초하고있다 . 

void Spreadsheet: : findNext(const QString &str, bool caseSensitive) 

{ 

int row = currentRow(); 

int col = currentColumn() + 1; 

while (row < NumRows) { 
while (col < NumCols) { 

if (text(row, col) .contains(str, caseSensitive)) { 
clearSelection(); 
setCurrentCell(row, col); 
setActiveWindow(); 
return; 

} 

++col; 

} 

col = 0; 

++row; 

} 

qApp->beep(); 

} 

findNextO 처리부는 그 세포로부터 시작하여 유표의 오른쪽으로 마지막 칸에 이를 때까지 
세포들을 오른쪽으로 순환하고 다음 행에서 첫 칸부터 시작하여 이 과정을 본문을 발견하거 
나 제일 마지막 세포에 이를 때까지 반복한다 . 례를 들면 현재세포가 세포 C27 이면 D27, 
E27, Z27 을 탐색 하고 그다음 A28, B28, C28, .... Z28, 그리 하여 Z999 까지 람색 한다 . 일치 하는 
것이 발견되면 현재선택을 지우고 세포유표를 일치하는 세포까지 옮기며 Spreadsheet 를 포함 
하는 창문을 능동으로 만든다 . 일치하는것이 없으면 응용프로그람이 벡소리를 내여 탐색이 
끝났다는것을 알리게 한다 . 

void Spreadsheet::findPrev(const QString &str, bool caseSensitive) 

{ 

int row = currentRow(); 

int col = currentColumn() - 1; 
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while (row >= 0) { 
while (col >= 0) { 

if (text(row, col).contains(str, caseSensitive)) { 
clearSelection(); 
setCurrentCell(row, col); 
setActiveWindow(); 
return; 

} 

— col; 

} 

col = NumCols - 1; 


— row; 

} 

qApp->beep(); 

} 

findPrevO 처 리 부는 findNextO 와 비숫하지만 거꾸로 순환하며 세포 시에서 중지 한다 . 


제5절. 다른 차림표의 실현 


이 제 는 Tools 와 Options 차림 표의 처 리 부들을 실 현 한다 . 


1 IOOl3 

I Options 

Recalculate F9 

| •_，Shov Grid 

Sort... 

「7 ^to-racalculate 


그림 4-9. 표계산프로그람의 Tools 와 Options 차림표 


void Spreadsheet: : recalculate() 

{ 

int row; 

for (row = 0; row < NumRows; ++row) { 
for (int col = 0; col < NumCols; ++col) { 
if (cell(row, col)) 
cell(row, col)->setDirty(); 

} 

} 

for (row = 0; row < NumRows; ++row) { 
for (int col = 0; col < NumCols; ++col) { 
if (cell(row, col)) 
updateCell(row, col); 
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recalculate^) 처리 부는 Tools|Recalculate 에 대응된다 . 또한 필요할 때 Spreadsheet 에 의 해 자동 
적으로 호출된다 . 

모든 세포들을 순환하면서 매개 세포에 대하여 setDirty() 를 호출하여 재계산을 요구하는 
것으로 표식한다 . 표에 현시할 값을 얻기 위하여 QTable 이 Cell 에 대하여 다음으로 text() 를 호 
출할 때 그 값은 다시 계산된다 . 

그다음 모든 세포들에 대하여 updateCellQ 를 호출하여 전체 표를 다시 그린다 . QTable 의 
재그리 기 코드는 보이 는 매개 세 포에 대 하여 text() 를 호출하여 현시할 값을 얻 는다 . 매 개 세포 
에 대하여 setDirtyO 를 호출하였으므로 text() 호출은 새로 계산한 값을 사용한다 . 계산은 Cell 클 
라스가 수행한다 . 

void Spreadsheet :: setAutoRecalculate(bool on) 

{ 

autoRecalc = on; 

if (autoRecalc) 
recalculate(); 

} 

setAutoRecalculate() 처 리 부는 Options!Auto-recalculate 에 대 응된 다 . 이 특성 이 설 정 되 였 으면 
즉시 전체 표를 재계산하여 그것이 갱신된다는것을 확인한다 . 후에 recalculate^ 가 
somethingChanged() 로부터 자동적으로 호출된다 . 

QTable 이 이미 setShowGrid(bool) 처리 부를 제공하므로 Options|Show Grid 에서 아무것도 실 
현할것 이 없다 . 남은것은 MainWindow::sort() 로부터 호출되는 Spreedsheet::sort() 이 다 . 
void Spreadsheet: : sort(const SpreadsheetCompare &compare) 

{ 

vector<QStringList> rows; 

QTableSelection sel = selection(); 

int i; 

for (i = 0; i < sel.numRows(); ++i) { 

QStringList row; 

for (int j = 0; j < sel.numCols(); ++j) 

row.push_back(formula(sel.topRow() + i,sel.leftCol() + j)); 
rows .push_back(row); 

} 

stable_sort(rows.begin(), rows.endQ, compare); 



for (i = : 公 ; t < sel.numRows(); ++i) { 

for (fat j = 0; j < sel.numCols(); ++j) 

setFonnula(sel.topRow() + i, sel.leftCol() + j,rows[i][j]); 

} 

clearSelection(); 
some 仕 iingChanged(); 

} 

정렬은 현재선택에 대하여 진행되고 정렬건과 비교객체에 보관된 정렬순서에 따라 행들 
을 기록한다 . QStringList 를 가지고 매개 자료형을 표시하고 선택을 행들의 백토르로 보관한다 . 
vectoKT 느클라스는 표준 C ++ 클라스로서 11 장(용기 클라스)에서 설명한다 . 간단히 값이 아니 라 
식에 따라서 정렬한다 . 



index 

value 

0 

[ "Edsger". "Dijkstra", "1930-05-11"] 

1 

[•'Tony*, "Hoare", "1934-01-11"] 

2 

[ "Niklaus", -Wirth_, "1934 02 15"] 

9 

["Donald". "Knuth". "1938-OMO"] 


그림 4-10. 선택내용을 행 벡 토르로 보관하기 

행들에 대하여 표준 C++ stable_sortO 함수를 호출하여 실제의 정렬을 진행한다 . stable_sort() 
함수는 begin 반복자， end 반복자 , 비교함수를 인수로 가진다 . 비교함수는 2 개의 인수 (2 개의 
QStringList ) 를 리용하여 첫째 인수가 둘째 인수보다 작으면 true, 그렇지 않으면 false 를 돌려 
주는 함수이다 . 비교함수에 넘 기는 비교객체는 실제로 함수가 아니지만 함수처 럼 사용할수 


效다 . 


index 

value 

0 

[ Donald", "Knuth". "1938-01 -10"] 

1 

[ Edsger-, "Dijkstra", "1930-05-11*1 

2 

[ Niklaus", "Wirth ■，- 1934-02-15" J 

3 

【 Tony". "Hoare" ， 1934*01-11，1 
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그림 4-11. 정렬한 자료를 표에 넣기 


stable_sort () 를 실행한 후에 자료를 표에로 옮기고 선택을 지우고 somethingChanged () 를 호 
출한다 . 


spreadsheet .!! 에 서 SpreadsheetCompare 클라스를 다음과 같이 정 의 한다 . 


class SpreadsheetCompare 


public: 
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bool operator()(const QStringList &rowl, const QStringList &row2) const; 
enum { NumKeys = 3 }; 
int keys[NumKeys]; 
bool ascending[NumKeys]; 

}； 

SpreadsheetCompare 클라스는 () 연산자를 실현하므로 특수한 클라스이다. 이것은 마치도 함 
수처럼 클라스를 사용하게 한다. 그러한 클라스들을 함수자 (functor) 라고 한다. 함수자들에 대 
하여 리해하기 위해 간단한 실례를 고찰한다. 
class Square 
{ 

public: 

int operator()(int x) const { return x * x; } 

}； 

Square 클라스는 하나의 함수 operator()(int) 를 제공한다. 이 함수는 파라메터의 두제급을 돌 
려준다. 이 함수를 compute(int) 가 아니라 operator()(int) 라고 명명함으로써 Square 형 객체를 함 
수처럼 사용할수 있게 된다. 

Square square; 
int y = square(5); 

그러면 SpreadsheetCompare 를 포함하는 실례를 고찰하자. 

QStringList rowl, row2; 

SpreadsheetCompare compare; 


if (compare(rowl, row2)) { 

// rowl is less than row2 


} 

compare 객체는 일반적인 compare () 함수처럼 사용된다. 또한 이것은 성원변수로서 보관하는 
모든 정렬건과 정렬순서를 호출할수 있다. 

다른 한가지 방법은 대역변수에 정렬건과 정렬순서를 보관하고 일반 compare 。 함수를 리용 
하는것 이다. 그러나 대 역변수를 사용하는것은 그리 좋지 못하고 포착하기 어 려운 오유를 일 
으킨 다. 함수자는 stable _ sortO 와 같은 형 판함수들을 리 용하기 위 한 더 강력한 수단이 다. 

여기에 표의 두 행을 비교하는데 사용하는 함수의 실현이 있다. 

bool SpreadsheetCompare : :operator() (const QStringList &rowl, const QStringList &row2) const 

{ 

for (int i = 0; i < NumKeys; ++i) { 
int column = keys[i]; 
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if (column != -1) { 

if (row 1 [column] != row2[column]) { 
if (ascending[i]) 

return row 1 [column] < row2[column]; 
else 

return row 1 [column] > row2[column]; 

} 

} 

} 

return false; 

} 

첫 행이 둘째 행보다 작으면 true, 그렇지 않으면 false 를 돌려준다 . stondardst:able_sortO 함수 
는 그 결과를 리용하여 정렬한다 . 

SpreadsheetCompare 객체의 건과 자모순배렬은 MainWindow::sort() 함수 (2 장에서 주었다.)에서 
정 의한다 . 매 개 건은 세포첨 수 혹은 -1 ("None ") 을 보관한다 . 

매개 건에 대하여 2 개의 행에 대응하는 세포항목들을 차례로 비교한다 . 차이를 발견하면 
true 혹은 false 값을 돌려준다 . 모든 비교가 같아지면 false 를 돌려준다 . stable_sort () 함수는 비김 
(tie ) 상황을 해결하는데 정렬건의 순서를 리용하며 본래 rowl 이 row2 을 앞서면 다른것보다 작 
은것으로서 아무것도 비교하지 않으며 결과에서도 여 전히 rowl 이 row2 를 선행한다 . 이 것은 
std::stable_sort () 이 std::sort () 와 차이 나는 점 이다 . 

이리하여 Spreadsheet 클라스를 완성하였다 . 다음 절에서는 Cell 클라스를 고찰한다 . 이 클라 
스는 세포식들을 보관하는데 쓰이며 Spreadsheet 가 세포의 식을 계산한 결과를 현시하기 위하 
여 호출하는 text () 함수의 실현을 제공한다 . 

제6절. QTableltem 의 파생클라스만들기 

Cell 클라스는 QTableltem 을 계승한다 . Cell 클라스는 Spreadsheet 와 잘 작업하도록 설계되지 
만 그 클라스에 대한 특별한 의존관계는 없고 리론적으로 QTable 에서 사용할수 있다 . 

여기에 머리부파일이 있다 . 


#ifndef CELL H 
#define CELL H 
#include <qtable.h> 

#include <qvariant.h> 
class Cell : public QTableltem 
{ 

public: 

Cell(QTable * table, const QString &formula); 
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void setFormula(const QString &formula); 

QString formula() const; 
void setDirty(); 

QString text() const; 
int alignment() const; 
private: 

QVariant value() const; 

QVariant evalExpression(const QString &str, int &pos) const; 

QVariant evalTerm(const QString &str, int &pos) const; 

QVariant evalFactor(const QString &str, int &pos) const; 

QString formulaStr; 
mutable QVariant cachedValue; 
mutable bool cachelsDirty; 

}； 

#endif 

Cell 클라스는 3 개의 비공개변수들을 추가하여 QTableltem 을 확장한다 . 

- formulas 仕는 세 포의 식 을 QString 으로 보관한다 . 

- cachedValue 는 계 포의 값을 QVariant 로서 보관한다 . 

• cachelsDirty 는 cachedValue 가 갱신되지 않으면 仕 ue 이다 . 

QVariant 형은 C++ 와 (가형의 값들을 보관할수 있 다 . 일부 세포들은 double 값을 가지고 다 
른 일부 세포들은 QString 값을 가지므로 이 형을 리용한다 . 

cachedValue 와 cachelsDirty 변수를 C++ mutable 예 약어 에 의 해 선 언하여 const 함수들에서 변 
경할수 있게 한다 . 또한 좀 비효과적 이지만 text() 를 호출할 때마다 그 값을 다시 계산할수 있 
다 . 

클라스선 언에 Q_OBJECT 마크로가 없다 . Cell 은 일반 C++ 클라스로서 신호나 처 리부가 없다 . 
사실상 QTableltem 은 QObject 를 계승하지 않으므로 Cell 에는 신호와 처리 부가 없다 . Qt 의 항목 
클라스들은 QObject 를 계 승하지 않음으로써 간접 비 를 최 소로 유지한다 . 신호와 처 리 부가 요구 
되면 항목들을 포함하는 창문부품으로 실현하거나 례외적으로 QObject 와의 다중계승을 리용 
하여 실현할수 있다 . 

여기에 cell.cpp 의 선두가 있다 . 

#include <qlineedit.h> 

#include <qregexp.h> 

#include "cell.h" 

Cell::Cell(QTable * table, const QString &formula) : QTableItem(table, OnTyping) 

{ 
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setF ormula(formula); 


} 

구성자는 QTable 의 지적자와 식을 받아들인다. 지적자는 QTableltem 구성자에로 넘어가고 
후에 QTableItem::table() 에서 호출할수 있다. 기초클라스구성자의 둘째 인수 OnTyping 은 사용 
자가 현재세포에서 입력을 시작할 때 편집기를 펼친다는것을 의미한다. 
void Cell :: setFormula(const QString &formula) 

{ 

formulaStr = formula; 
cachelsDirty = true; 

} 

setFormula() 함수는 세포의 식을 설정 한다. 또한 cachelsDirty 기발을 true 로 설정 하는데 이것 
은 유효값이 돌아오기 전에 cachedValue 를 다시 계산해 야 한다는것을 의 미한다. 이 것은 Cell 구 
성자와 Spreadsheet::setFomiula() 로부터 호출된다. 

QString Cell::formula() const 

{ 

return formulaStr; 

} 

formula() 함수는 Spreadsheet::formulaO 로부터 호출된다. 
void Cell::setDirty() 

{ 

cachelsDirty = true; 

} 

setDirtyO 함수는 세포의 값을 다시 계산하기 위하여 호출한다. 이 함수는 단지 cachelsDirty 
를 true 로 설정한다. 재계산은 실제로 필요할 때까지 수행되지 않는다. 

QString Cell::text() const 

{ 

if (value().isValid()) 

return value().toString(); 
else 

return ，，####，，; 

} 

text() 함수는 QTableltem 으로부터 재정의된다. 이 함수는 표에 현시하려는 본문을 돌려준다. 
이것은 value() 에 기초하여 세포의 값을 계산한다. 값이 무효이면(식이 틀려서) ’’####’’를 돌려 
준다. 

text() 에서 사용한 value() 함수는 QVariant 를 돌려준다. QVariant 는 double, QString 과 같은 각 
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이한 형의 값들을 보관할수 있고 가변형을 다른 형으로 변환하는 함수들을 제공한다 . 례를 
들면 double 값을 보관하는 가변형 에 대 한 toStringO 호출은 double 의 문자렬표시 를 생성 한다 . 기 
정 구성 자를 리 용하여 구성 한 QVariant 는 《무효한》가변 형 이 다 . 
int Cell :: alignment() const 
{ 

if (value().type() == QVariant::String) 
return AlignLeft | AlignVCenter; 

else 

return AlignRight | AlignVCenter; 

} 

alignment() 함수는 QTableltem 로부터 재정의된다 . 이 함수는 세포본문의 배렬방법을 돌려준 
다 . 문자렬에 대해서는 왼쪽정렬을，수값에 대해서는 오른쪽정렬 설정한다 . 또한 모든 값들을 
수직으로 중심에 배렬한다 . 
const QVariant Invalid; 

QVariant Cell::value() const 

{ 

if (cachelsDirty) { 

cachelsDirty = false; 
if (formulaStr.startsWith( ,m, )) { 

cachedValue = formulaStr.mid(l); 

} else if (formulaStr.startsWith('-")) { 
cachedValue = Invalid; 

QString expr = formulaStr.mid( 1); 
expr.replace( M ",，，，，); 
int pos = 0; 

cachedValue = evalExpression(expr, pos); 
if (pos < (int) expr.length()) 
cachedValue = Invalid; 

} else { 
bool ok; 

double d = formulaStr.toDouble(&ok); 
if (ok) 

cachedValue = d; 

else 


cachedValue = formulas 仕 ; 



} 


} 

return cachedValue; 

} 

value() 비공개함수는 계포의 값을 돌려준다 . cachelsDirty 가 true 이 면 값을 다시 계산할 필요 
가 있다 . 

식이 =로 시작하면 문자렬을 위치 1 로부터 취하고 그것이 포함하는 공백을 삭제한다 . 그 
다음 evalExpressionO 을 호출하여 식의 값을 계산한다 . pos 인수는 참고로 넘 어 가고 이 것은 문장 
해석을 시작하는 문자의 위치를 가리킨다 . evalExpression() 의 호출후에 pos 는 성과적으로 문장 
해석된 식의 길이와 같다 . 끝에 이르기전에 문장해석에서 실패하면 cachedValue 를 Invalid 로 설 
정 한다 . 

식 이 단일인용부호나 같이 기 호 (=) 로 시 작되 지 않으면 toDouble() 에 의 하여 류점 수값으로 
변환한다 . 변환되면 cachedValue 를 결과수값으로 설정하고 그렇지 않으면 cachedValue 를 식문 
자렬 로 설 정한다 . 례 를 들면 식 1.50 은 toDouble() 에 서 성 공하여 1.5 를 돌려 주고 식 "World 
Population" 은 실패하여 0.0 을 돌려주게 한다 . 

value() 함수는 const 함수이다 . cachedValue 와 cachelsValid 를 mutable 변수로 선 언 함으로써 
const 함수들에서 그 변수를 수정 할수 있게 한다 . valueO 를 비 상수함수로 만들어 mutable 예 약어 
들을 제 거할수 있으나 const 함수 text() 로부터 value() 를 호출하므로 콤파일되 지 않는다 . 보통 
C++ 에 서 캐 성 과 mutable 은 서 로 협 력 한다 . 

이제는 식해석에 의존하지 않는 표계산프로그람을 만들었다 . 이 절의 나머지 부분에서는 
evalExpression() 과 2 개의 보조함수 evalTerm() 과 eva!Factor() 를 설명한다 . 코드는 좀 복잡하지만 
이것을 포함하여 응용프로그람을 완성한다 . 

evalExpression() 함수는 표계산식의 값을 돌려준다 . 식은 +나 -연산자들로 구분된 하나이상 
의 항들로서 정의된다 . 례를 들면 2*C5+D6 은 첫 항이 2*C5 이고 둘째 항이 어인 식이다 . 항 
자체는 * 이나 /연산자들로 구분된 하나이상의 인수들로 정의된다 . 례를 들면 2*C5 는 첫 인수 
가 2, 둘째인수가 C5 인 항이다 . 끝으로 인수는 수 (2), 세포위치 (C5), 혹은 괄호안의 식(단항 - 
부호가 앞에 있을수 있다:)일수 있다 . 식을 항들로，항을 인수들로 분리하여 연산자들이 정확 
한 수속에 적용되도록 한다 . 

표계산식의 문법은 그림 4-12 에서 정의된다 . 문법의 매개 기호 (Expression^ Term 그리고 
Factor) 에 대하여 그것을 해석하는 대응하는 Cell 성원함수가 있고 그 구조는 엄격히 문법을 따 
른다 . 이 런 방법 으로 작성한 문장해석 기는 재귀 적 인 하강식 문장해석기 (recursive-descent parser) 
라고 부론다 . 
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그림 4-12. 표계산식의 문법도표 
식을 해석하는 함수 evalExpression() 부터 고찰한다 . 

QVariant Cell::evalExpression(const QString &str, int &pos) const 

{ 

QVariant result = evalTerm(str, pos); 
while (pos < (int)str.length()) { 

QChar op = str[pos]; 

if (op != ’+’ && op != -') return result; 

++pos; 

QVariant term = evalTerm(str, pos); 

if (result.type() == QVariant: :Double && term.type() == QVariant: : Double) { 
if (op =，+，) 

result = result.toDouble() + term.toDouble(); 
else 

result = result.toDouble()-term.toDouble(); 

} else { 

result = Invalid; 

} 

} 

return result; 

} 

우선 evalTermO 을 호출하여 첫 항의 값을 얻는다 . 다음 문자가 +나 -이면 두번째로 
evalTermO 를 호출하고 그렇지 않으면 식은 하나의 항으로 이루어지고 그 값을 전체식의 값으 
로서 돌려준다 . 처음 두개 항의 값을 얻은 후에 연산자에 따라 연산결과를 계산한다 . 두 항이 
double 로 평가되면 결과를 double 로 계산하고 그렇지 않으면 결과를 Invalid 로 설정한다 . 

이 계산은 항이 더는 없을 때까지 계속된다 . 이것은 더하기와 덜기가 왼쪽결합이므로 즉 
1-2-3 은 1-(2-3) 이 아니 라 (1-2)-3 이 므로 제 대로 작업한다 . 

QVariant Cell: :evalTerm(const QString &str, int &pos) const 


QVariant result = evalFactor(str, pos); 
while (pos < (int)str.length()) | 
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QChar op = str[pos]; 

if (op !=，*，&& op != V，) return result; 

++pos; 

QVariant factor = evalFactor(str, pos); 

if (result.type() == QVariant: :Double && factor.type() = QVariant: : Double) { 
if (op ==，*，) { 

result = result.toDouble() * factor.toDouble(); 

} else { 

if (factor.toDouble() == 0.0) 
result = Invalid; 

else 

result = result.toDouble() / factor.toDouble(); 

} 

} else { 

result = Invalid; 

} 

} 

return result; 

} 

evalTemi () 함수는 급하기와 나누기를 취급하는것을 제외하면 evalExpression () 과 아주 비숫 
하다 . evalTermO 에서 포착하기 어 려 운 유일한 문제는 0 에 의 한 나누기 를 피 하는것 이 다 . 류점 수 
들의 등가성 을 시 험 하는것 은 반올림 오유로 인하여 일 반적 으로 적 당하지 않다 . 령에 의 한 나 
누기를 방지하는것이 안전하다 . 

QVariant Cell: : evalFactor(const QString &str, int &pos) const 

{ 

QVariant result; 
bool negative = false; 
if (str[pos] = ’」) { 
negative = true; 

++pos; 

} 

if (str[pos] ■ X 1 ) { 

++pos; 

result = evalExpression(str, pos); 
if (str[pos] != y) 
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result = Invalid; 


++pos; 

} else { 

QRegExp regExp("[A-Za-z] [1-9] [0-9] {0,2}") ; 
QString token; 

while (str[pos].isLetterOrNumber() || str[pos] == V) { 
token += str[pos]; 

++pos; 

} 

if (regExp.exactMatch(token)) { 

int col = token[0].upper().unicode() - ’A’; 
int row = token.mid( 1) .toInt() - 1; 

Cell *c = (Cell *)table()->item(row, col); 

if (c) 

result = c->value(); 

else 

result = 0.0; 

} else { 
bool ok; 

result = token. toDouble(&ok); 
if (!ok) 

result = Invalid; 

} 

} 

if (negative) { 

if (result.type() == QVariant::Double) 
result = -result. toDouble(); 
else 

result = Invalid; 

} 

return result; 

} 

eva!Factor() 함수는 evalExpression() 과 evalTerm() 보다 좀 더 
알리는것으로 시작한다 . 그다음 열린괄호로 시작하는가 
evalExpression() 를 호출하여 괄호의 내용을 식으로 평가한다 . 


복잡하다 . 인수가 부수인가를 
확인한다 . 괄호로 시작하면 
이것은 문장해석기에서 재귀가 
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발생하는 곳이며 evalExpression() 은 evalTerm() 를 호출하고 evalTerm() 는 evalFactor() 를， 
evalFactor() 는 evalExpression() 를 다시 호출한다 . 

인수가 겹쌓인 식이 아니면 세포위치나 수값일수 있는 다음 토큰을 꺼낸다 . 토큰이 
QRegExp 와 일치하면 그것을 세포참고로 취하고 주어진 위치의 세포에 대하여 valueO 를 호출 
한다 . 세포는 표의 어디에나 있을수 있으며 다른 세포들과 의존관계를 가질수 있다 . 의존관계 
는 문제가 아니며 단순히 value() 를 다시 호출하고 (dirty 세포들에 대하여 ；) 의존하는 모든 세포 
값들이 계 산될 때 까지 해 석한다 . 토큰이 세 포위 치 가 아니 면 그것 을 수로 취 급한다 . 

세포 A1 이 식 =A1 을 포함하면 어떤 일이 생기는가 ? 혹은 세포 A1 이 =A2 을 , 세포 A2 이 
=A1 을 포함한다면 어 떤 일 이 생 기 는가 ? 비 록 순환하는 의 존관계 를 탐지 하기 위한 특별 한 코 
드를 쓰지 않았지만 문장해석기는 무효한 QVariant 를 돌려줌으로써 이 경우를 훌륭히 처리한 
다 . evalExpression() 를 호출하기전에 value() 에서 cachelsDirty 를 false 로 설정하고 cachedValue 를 
Invalid 로 설정 하므로 이 것은 제 대로 작업 한다 . evalExpressionO 이 같은 세포에 대하여 재귀 적 으 
로 value() 를 호출한다면 즉시 Invalid 를 돌려주며 그때 전체 식은 Invalid 로 평가된다 . 

이제는 식해석기를 완성하였다 . sumO 과 avgO 와 같이 미리 정의된 표계산함수들을 조종하 
도록 확장하는것은 간단하다 . 인수의 문법정의를 확장하면 된다 . 다른 간단한 확장은 문자렬 
연산수에 대하여 +연산자를 실현하는것 이 며 이 것은 문법변경 을 요구하지 않는다 . 
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제 5 장. 사용자정의창문부품의 만들기 

이 장에서 는 Qt 를 리 용하여 사용자정 의창문부품을 창조하는 방법 을 설 명한다 . 사용자정 의 
창문부품은 Qt 의 현존창문부품들의 파생클라스를 만들거나 QWidget 의 파생클라스를 직접 만 
들어서 창조할수 있다 . 여 기서는 두가지 수법 을 모두 보여 주며 사용자정의창문부품을 Qt 
Designer 에 통합하여 Qt 기본창문부품처럼 사용하는 방법을 보여준다 . 끝으로 깜빡거림을 제거 
하는 강력한 기술 즉 2 중완충기술을 사용하는 사용자정의창문부품을 제시한다 . 

제1절. Qt 창문부품들의 사용자정의 

일부 경우에 여 쇼)에서 Qt 창문부품의 속성들을 설정하거나 함수들을 호출하여 될수 
록 전용화할것을 요구한다 . 단순하면서 직접적인 해결은 관련한 창문부품클라스의 파생클라 
스를 만들고 요구에 맞게 적용하는것이다 . 



그림 5-l.HexSpinBox 창문부품 

이 절에서는 16 진수스핀칸을 개발하여 그 작업방법을 보여준다 . QSpinBox 는 오직 m 진옹 
근수만 유지하지만 그 파생클라스를 만들어 16 진수값들을 받아들이고 표시하는것은 아주 간 
단하다 . 


#ifndef HEXSPINBOX H 
#define HEXSPINBOX H 
#include <qspinbox.h> 
class HexSpinBox : public QSpinBox 
{ 

public: 

HexSpinBox(QWidget *parent, const char *namet#vO); 
protected: 

QS 仕 ing map Value ToText(int value); 
int mapTextToYalue(bool *ok); 

}； 

#endif 

HexSpinBox 는 QSpinBox 로부터 대부분의 기능을 계승한다 . 이 클라스는 전형적인 구성자 
를 제공하고 QSpinBox 로부터 2 개의 가상함수를 실현한다 . 클라스가 자체의 신호와 처리 부를 
정의하지 않으므로 Q_OBJECT 마크로가 필요없다 . 

#include <qvalidator.h> 

#include "hexspinbox.h" 
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HexSpinBox: : HexSpinBox(QWidget ^parent, const char *name) : QSpinBox(parent, name) 

{ 

QRegExp regExp("[0-9A-Fa-f]+"); 

setValidator(new QRegExpValidator(regExp, this)); 

setRange(0,255); 

} 

사용자는 스핀칸의 올리，내리화살표를 찰칵하거나 스핀칸의 행편집기에 값을 입력하여 
현재 값을 수정할수 있다 . 값을 직 접 입 력 하는 경 우 정 확한 16 진수를 입 력 하도록 제 한하려 고 
한다 . 그러기 위하여 범위 0 〜 9, A~F, a~f 로부터 하나이상의 문자들을 받아들이는 
QRegExpValidator 를 리용한다 . 또한 기 정범위를 0 〜 255(0x00 〜 OxFF) 로 설정한다 . 이것은 
QSpinBox 의 기정값 0 〜 99 보다 16 진수 스핀칸에 더 적합하다 . 

Q String HexSpinBox: : mapValueToText(int value) 

return QString: : number(value, 16).upper(); 

} 

mapValueToTextO 함수는 옹근수값을 문자렬로 변환한다 . QSpinBox 는 이 함수를 호출하여 
사용자가 스핀칸의 올리 혹은 내리화살표를 누를 때 스핀칸의 편집기부분을 갱신한다 . 둘째 
인수로서 16 을 가지 는 정 적함수 QStting :: numberO 를 리 용하여 소문자 16 진 수로 값을 변 환하고 
결과에 대하여 QStringxupperO 를 호출하여 그것을 대문자로 만든다 . 

int HexSpinBox: : mapTextToValue(bool *ok) 

{ 

return text().toInt(ok, 16); 

} 

mapTextToValue() 함수는 문자렬로부터 옹근수값에 로의 역변 환을 진 행 한다 . 사용자가 스핀 
칸의 편집 기 부분에 값을 입 력 하고 Enter 를 누르면 이 함수가 QSpinBox 에 의해 호출된다 . 
QString :: toIntO 함수에 의하여 현재 본문 (QSpinBox :: textO 로부터 돌아온다)을 16 진옹근수값으로 
변환한다 . 

변 환이 성 공하면 toInt() 는 *ok 를 true 로 설 정 하고 그렇 지 않으면 false 로 설 정한다 . 

이제는 16 진스핀칸을 완료하였다 . 다른 Qt 창문부품만들기도 우와 갈은 방법으로 진행한다 . 
즉 적당한 Qt 창문부품을 선택하고 그 파생클라스를 만들고 가상함수들을 재정의하여 동작을 
변경한다 . 이 수법 은 Qt 프로그람작성 에 서 보편적 이 고 사실상 이 미 4 장에서 QTable 의 파생 클라 
스를 만들고 createEditorO 와 endEdit() 를 재정의할 때 사용하였다 

제2절. QWidget 의 파생클라스만들기 

대 부분의 사용자정 의창문부품들은 그것 이 Qt 내 부창문부품이 든 HexSpinBox 와 갈은 사용자 
정 의창문부품이든 순수 현 존창문부품들의 결 합이 다 . 현 존창문부품들을 결 합하여 건설하는 사 

104 




용자정 의창문부품들은 보통 Qt Designer 로 개 발할수 있 다. 즉 

•Widget 형판을 사용하여 새 폼을 작성한다. 

• 폼에 필 요한 창문부품들을 추가하고 배 치한다. 

• 신호와 처리부련결을 설정하고 . ui.h 파일 혹은 파생클라스에 필요한 코드를 추가하여 요 
구되는 동작을 제공한다. 

이것은 완전히 코드로도 수행할수 있다. 어떤 방법을 취하든간에 결과클라스는 QWidget 
로부터 직접 계승된다. 

창문부품이 자체의 신호와 처리부를 가지지 않고 가상함수들을 재정의하지 않으면 파생 
클라스없이 현존창문부품들을 수집하여 창문부품을 간단히 조립할수도 있다. 그것은 1장에서 
QHBox , QSpinBox , QSlider 를 Age 응용프로그람을 창조하는데 사용한 수법이다. 그러나 
QHBox 의 파생클라스를 간단히 만들고 파생클라스의 구성자에서 QSpinBox 와 QSlider 를 창조 
하였다. 

Qt 의 어떤 창문부품도 현재의 과제에 적합하지 않을 때와 현존창문부품들을 결합하거나 
적용하여 요구되는 결과를 엄는 방법이 없을 때에는 요구되는 창문부품을 창조한다. 이것은 
QWidget 의 파생클라스를 만들고 몇가지 사건처리함수들을 재정의하여 창문부품을 그리고 마 
우스찰칵에 응답하게 하는 방법 으로 달성한다. 이 수법 은 완전히 자유롭게 창문부품의 표현 
과 동작을 정의하고 조종하게 한다. QLabel , QPushButton , QTable 과 같은 여의 기본창문부품들 
은 이렇게 실현된다 . Qt 에 그것들이 존재하지 않으면 총체적으로는 가동환경에 의존하지 않는 
방법으로 QWidget 가 제공하는 공개함수들을 리용하여 자체로 창조할수 있다. 

이러한 수법으로 사용자정의창문부품을 쓰는 방법을 보여주기 위하여 그림 5-2 에 보여주 
는 IconEditor 창문부품을 창조한다. IconEditor 는 그림기호편집프로그람에서 사용할수 있는 창문 
부품이다. 



그림 5-2. IconEditor 창문부품 


머리부파일부터 고찰하자. 
#ifodef ICONEDITOR_H 
#define ICONEDITOR_H 
#include < qimage . h > 

#include < qwidget . h > 

class IconEditor : public QWidget 
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{ 


Q_OBJECT 

Q_PROPERTY(QColor penColor READ penColor WRITE setPenColor) 

Q_PROPERTY(Qlmage iconlmage READ iconlmage WRITE setlconlmage) 

Q_PROPERTY(int zoomFactor READ zoomFactor WRITE setZoomFactor) 
public: 

IconEditor(QWidget *parent = 0， const char *name = 0); 
void setPenColor(const QColor &newColor); 

QColor penColor()const { return curColor; } 
void setZoomFactor(int newZoom); 
int zoomFactor() const { return zoom; } 
void setIconImage(const Qlmage &newlmage); 
const Qlmage &iconImage() const { return image; } 

QSize sizeHint() const; 

IconEditor 클라스는 Q_PROPERTY() 마크로를 리용하여 3 개의 사용자정의속성 penColor, 
iconlmage, zoomFactor 를 선 언 한다 . 매 개 속성 은 형，《읽 기》함수 , 《쓰기》함수를 가진 다 . 례 를 
들면 penColor 속성은 QColor 이고 penColor () 와 setPenColor () 함수들에 의하여 읽고쓸수 있다 . 

Qt Designer 에서 창문부품을 사용할 때 사용자정의속성들이 Qt Designer 의 속성편집기에 
QWidget 로부터 계승되는 속성들아래에 나타난다 . 속성은 QVariant 가 유지하는 형일수 있다 . 
Q_OBJECT 마크로는 속성을 정의하는 클라스들에 필요하다 . 
protected: 

void mousePressEvent(QMouseEvent * event); 
void mouseMoveEvent(QMouseEvent *event); 
void paintEvent(QPaintEvent * event); 
private: 

void drawImagePixel(QPainter *painter, int i, int j); 
void setImagePixel(const QPoint &pos, bool opaque); 

QColor curColor; 

Qlmage image; 
int zoom; 

}； 

#endif 

IconEditor 는 QWidget 로부터 3 개의 보호함수를 재정의하고 여러개의 비공개함수와 변수들 
을 가전 다 .3 개 의 비 공개 변 수는 3 가지 속성 의 값들을 보관한다 . 

실 현 파일 은 #include 지 령 과 IconEditor 의 구성 자로 시 작된 다 . 
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#include <qpainter.h> 

#include "iconeditor.h" 

IconEditor: :IconEditor(QWidget *parent, const char *name) 

: QWidget(parent, name, WStaticContents) 

I 

setSizePolicy(QSizePolicy :: Minimum, QSizePolicy: : Minimum); 
curColor = black; 
zoom = 8; 

image.create(16, 16, 32); 
image.fill(qRgba(0, 0, 0, 0)); 
image. set AlphaBuffer (tine); 

} 

구성자는 setSizePolicy () 호출과 WStaticContents 기발과 같은 미묘한 점들을 가진 다 . 그것들 
을 간단히 론의한다 . 

확대곁수는 8 로 설정되고 이것은 그림기호안의 매개 화소가 8 새인 바른 4 각형으로 표시된 
다는것을 의 미한다 . 펜색갈은 흑색으로 설정 되 고 흑색 기 호는 Qt 클라스災 Object 의 기초클라스 ) 
에서 미리 정의된 값이다 . 

그림기호자료는 image 성원변수에 보관되고 setIconImage () 와 iconImage () 함수를 통하여 호 
출될수 있다 . 일반적으로 그림기호편집프로그람은 그림기호파일을 열 때 setIconImage() 를 , 사 
용자가 그림 기 호파일을 닫으려 고 할 때 그림기 호를 얻 기 위 하여 iconlmageG 를 호출한다 . 

image 변수는 Qlmage 형이다 . 그것을 16><16 화소와 32bit 깊이로 초기화하고 화상자료를 지우 
며 알파완충기를 허용한다 . 

Qlmage 클라스는 하드웨어에 의존하지 않는 형식으로 화상을 보관한다 . 이 클라스는 lbit, 
8bit 혹은 32bit 깊 이 를 사용하도록 설 정할수 있다 . 32bit 깊 이 의 화상은 화소의 적，록，청 요소에 
각각 8bit 를 리용한다 . 나머지 8bit 는 화소의 알파요소 즉 불투명도를 보관한다 . 례를 들면 순 
수한 적 색의 적，록，청 과 알파요소는 값 255,0,0 과 255 를 가전다 . Qt 에서 이 색은 

QRgb red = qRgba(255, 0, 0, 255); 

과 같이 지정되거나 

QRgb red = qRgb(255, 0, 0); 

와 같이 지정될수 있다 . 

QRgb 는 unsigned int 의 형정의 이고 qRgb () 와 qRgba () 는 32bit 옹근수값으로 인수들을 결합하 
는 inline 함수들이다 . 또한 다음과 같이 쓸수도 있다 . 

QRgb red = 0xFFFF0000; 

여기서 첫 FF 는 알파요소에 대응하고 둘째 FF 는 적색요소에 대응한다 . IconEditor 구성자에 
서는 알파요소로서 0 을 리용하여 투명색으로 Qlmage 를 채운다 . 
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어는 색을 보관하는 2 가지 형 즉 QRgb 와 QColor 를 제공한다 . QRgb 가 32bk 화소자료를 보 
관하기 위해 Qlmage 에서 사용된 형정의이지만 QColor 는 사용가능한 수많은 함수들을 가지는 
클라스로서 어에서 색을 보관하는데 널리 사용된다 . IconEditor 창문부품에서는 Qlmage 를 론할 
때 QRgb 만 사용하며 penColor 속성을 비롯하여 그밖의 모든것에는 QColor 를 사용한다 . 

QSize IconEditor::sizeHint() const 

{ 

QSize size = zoom * image.size(); 
if (zoom >= 3) 

size += QSize(l, 1); 
return size; 

} 

sizeHint () 함수는 QWidget 로부터 재정의되고 창문부품의 리상크기를 돌려준다 . 여기서는 
화상크기 에 zoom 곁수를 급하고 zoom 곁수가 3 이상이면 각 방향으로 여유로서 1 화소를 더하여 
살창을 조절한다 . (zoom 곁수가 2 나 1 이 면 그림기호의 화소와 같은 칸으로 되므로 살창은 표시 
되지 않는다 .) 

대체로 창문부품의 크기암시는 배치체계와 결합되 여 쓰일수 있다 . Qt 의 배치관리자들은 
폼의 자식창문부품들을 배치할 때 창문부품의 크기암시를 최대한 고려하려고 한다 . IconEditor 
가 좋은 배 치 도구로 되 자면 그것 이 신용할만한 크기암시 를 알려 주어 야 한다 . 

크기암시 와 함께 창문부품들을 늘이 겠는가 줄이 겠는가를 배치체계 에 알리 는 크기 방략을 
가진 다 . 구성 자에 서 수평 과 수직 크기 방략으로서 QSizePolicy :: Minimum^- 리 용하여 
setSizePolicyO 를 호출함으로써 창문부품의 크기 암시가 실제로 그 최소크기 이 라는것을 배치관 
리 자에 알려야 한다 . 다시 말하여 창문부품은 필요하다면 그 크기 를 늘일수 있지만 크기암시 
아래로 줄일수 없다 . 이것은 창문부품의 sizePolicy 속성을 설정하여 Qt Designer 에서 거절할수 
있다 . 여 러가지 크기방략들의 의미는 6 장 ( 배치관리)에서 설명한다 . 

void IconEditor: : setPenColor(const QColor &newColor) 

{ 

curColor = newColor; 

} 

setPenColor () 함수는 현재펜색을 설정한다 . 그 색은 새로 그리는 화소에 사용될수 있다 . 

void IconEditor: : setIconImage(const Qlmage &newlmage) 

{ 

if (newlmage != image) { 

image = newImage.convertDepth(32); 

image.detach(); 

update(); 



updateGeome 仕 y (); 


} 

setlconlmageO 함수는 편 집 하려 는 화상을 설 정한다. 32bit 화상이 아닌 경 우에 는 
convertDepthO 를 호출하여 32bit 화상으로 만든다. 코드의 모든곳에서 화상자료가 32bit QRgb 값 
으로 보관되 는것 으로 가정한다. 

또한 detach() 를 호출하여 화상에 보관된 자료의 깊이사본을 엄는다. 이것은 화상자료가 
ROM 에 보관될수 있기때문에 필요하다. Qlmage 는 정확히 요구될 때만 화상을 복사하여 시간 
과 기억기를 절약하려고 한다. 이러한 최량화를 명시적공유라고 하며 11 장의 4 절에서 
(기닌 6111 쇼 1 ^ 7 < 1 >를 론의 한다. 

image 변수를 설정한 후에 QWidgetxupdateO 를 호출하여 새 화상으로 창문부품을 다시 그 
리 게 한다. 다음에 Q'WidgetxupdateGeometryO 를 호출하여 크기 암시 가 달라진 창문부품을 포함 
한다는것 을 배 치 관리 자에 알린다. 그때 배 치 관리 자는 자동적 으로 새 로운 크기암시 를 받아들 
인다. 

void IconEditor::setZoomFactor(int newZoom) 

{ 

if (newZoom < 1) 
newZoom w 

if (newZoom != zoom) { 
zoom = newZoom; 
update(); 

updateGeome 仕 y(); 

} 

} 

setZoomFactorO 함수는 화상의 zoom 곁 수를 설 정 한다. 후에 0 에 의 한 나누기 를 방지 하기 위 
하여 1 아래의 값은 수정한다. updateO 와 updateGeometryO 를 호출하여 창문부품을 다시 그리 고 
크기암시변경 에 대 하여 배 치 관리 자에 통지한다. 

penColor(), iconImage(), zoomFactor() 함수들은 머 리 부파일 에서 inline 함수들로 실현된다. 

이제는 paintEventO 함수의 코드를 고찰한다. 이 함수는 IconEditor 의 가장 중요한 함수로서 
창문부품이 다시 그려 질 때마다 호출된다 . QWidget 의 기정 적으로 아무 일도 하지 않고 창문부 
품은 비 여있 다. 

3 장에 서 언급한 contextMenuEventO 와 closeEventf) 와 같이 paintEventO 는 사건 처 리함수이다. 
Qt 는 다른 사건처리함수들을 수많이 가지고있다. 그 매개는 각이한 형의 사건에 대응한다. (7 
장에서 는 사건처 리 에 대하여 깊 이 설명한다.:) 

그리기 사건이 발생하고 paintEventO 가 호출되는 경우는 다음과 같다. 
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• 창문부품이 처음으로 표시될 때 체계는 자동적으로 그리기사건을 생성하여 창문부품을 
자체로 그리게 한다 . 

- 창문부품의 크기가 조절될 때 체계는 자동적으로 그리기사건을 생성한다 . 

• 창문부품이 다른 창문에 의하여 가리워졌다가 다시 나타나면(:창문체계가 그 구역을 보 
관하지 않으면 ) 가리워졌던 구역에 대하여 그리기사건이 발생된다 .. 

또한 QWidget :: updateO 나 QWidget::repaintO 를 호출하여 그리기사건을 강제로 발생시킬수도 
있다 . 이 두 함수들사이의 차이는 repaint(^ 즉시 재그리기를 진행하지만 update () 는 단순히 
Qt 가 다음에 사건들을 처리할 때 그리기사건을 발생한다는데 있다 . (두 함수는 창문부품이 화 
면에 표시되지 않으면 아무 일도 하지 않는다 .) update () 가 여러번 호출되면 Qt 는 깜빡거림을 
피하기 위하여 그리기사건들을 하나의 그리기사건으로 압축한다 . IconEditor 에서는 늘 update() 
을 사용한다 . 

여기에 코드가 있다 . 

void IconEditor: : paintEvent(QPaintEvent *) 

{ 

QPainter painter(this); 

if (zoom >= 3) { 

painter.setPen(colorGroup().foreground()); 
for (int i = 0; i <= image.width(); ++i) 

painter.drawLine(zoom * i, 0, zoom * i, zoom * image.height()); 
for (int j = 0; j <= image.height(); ++j) 

painter.drawLine(0, zoom * j, zoom * image.width(), zoom * j); 

} 

for (int 0 ； i < image.width(); ++i) { 
for (int j = 0; j < image.height(); ++j) 
drawImagePixel(&painter, i, j); 

} 

} 

창문부품에 QPainter 객체를 창조한다 . zoom 곁수가 3 이상이면 QPainter :: drawLineO 함수에 의 
하여 살창을 구성하는 수평 및 수직선들을 그린다 . 

QPainter :: drawLine () 호출은 다음의 문법을 가지고있다 . 

painter.drawLinef3c/, yl, x2, y2); 

여기서 (x7j ； 7 ) 는 직선의 한 끝의 위치， (x2j ； 2 ) 는 다른 끝의 위치이다 . 또한 4 개의 int 대신 
에 2 개의 QPoint 를 가지는 다중정의판의 함수가 있다 . 

Qt 창문부품의 왼쪽웃구석 화소는 위치 (0 ， 0) 에 배치되고 오른쪽 아래구석의 화소는 
(width()- 1 ， heightO-1 ) 에 배치된다 . 이것은 관례적 인 데카르트자리표계와 비슷하지만 y 축의 방 
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향이 바뀌고 프로그람작성에서 많이 사용된다 . 이행 , 비례，회전，자름과 갈은 변환을 리용하 
여 QPainter 의 자리 표계를 변환할수도 있다 . 이 것은 8 장 (2 차원 및 3 차원도형처 리：)에서 설명한 
다 . 

( 0 . 0 ) 



그림 5-3. QPainter 에 의 한 직 선의 그리 기 

QPainter 에 대 하여 drawLineO 를 호출하기전 에 setPen() 에 의 하여 선 의 색 을 설 정 한다 . 흑색 
이나 재색과 갈은 색을 코드로 작성할수 있으나 창문부품의 조색판을 사용하는것이 더 좋은 
수법 이 다 . 

매개 창문부품에는 사용할 색을 지정하는 조색판이 구비된다 . 례를 들면 창문부품들의 배 
경 색 (보통 밝은재 색)을 위한 조색 판항목과 배 경 우에 표시 되 는 본문색 (보통 흑색)을 위한 조색 
판항목이 있다 . 기정으로 창문부품의 조색판은 창문체계의 색구조를 받아들인다 . 조색판의 색 
을 리용하여 IconEditor 가 사용자의 선택을 고려하도록 한다 . 

창문부품의 조색판은 3 개의 색묶음 즉 능동 , 비능동 및 금지로 이루어진다 . 사용하려는 
색묶음은 창문부품의 현재상태에 의존한다 . 

• 능동색 묶음 (active color group) 은 현재 눙동인 창문안에 있는 창문부품들에서 사용된다 . 

• 비 능동색 묶음 (inactive color group) 은 다른 창문들안의 창문부품들에 서 사용된 다 . 

• 금지 색 묶음 (disable color group) 은 임의의 창문의 금지된 창문부품들에서 사용된다 . 

QWidget::palette() 함수는 창문부품의 조색판을 QPalette 객체로서 돌려준다 . 색묶음은 

QPalette 의 ad:ive(), inactive(), disabled() 함수들을 통하여 유효로 되며 QColorGroup 형 이 다 . 편리상 
QWidget::colorGroup() 는 창문부품의 현재 상태에 대한 정확한 색묶음을 돌려주므로 간혹 조색 
판을 직접 호출해야 한다 . 

paintEvent() 함수는 화상자체를 그리는것으로 끝난다 . 이때 IconEditor::drawImagePixel() 함수 
에 의하여 그림기호의 매개 화소를 색칠한 바른 4 각형을 그린다 . 
void IconEditor: : drawImagePixel(QPainter *painter, int i, int j) 

{ 

QColor color; 

QRgb rgb = image.pixel(i, j); 
if (qAlpha(rgb) == 0) 

color = colorGroup() .base(); 


111 





else 


color. setRgb(rgb); 
if (zoom >= 3) { 

painter->fillRect(zoom * i + 1， zoom * j + 1, zoom -1, zoom -1, color); 

} else { 

painter->fillRect(zoom * i, zoom * j, zoom, zoom, color); 

} 

} 

drawImagePixelO 함수는 QPainter 에 의하여 확대된 화소를 그린다 . i 와 j 파라메터는 창문부 
품이 아니 라 Qlmage 의 화소자리 표이 다 . (zoom 곁수가 1 이 면 두개 자리 표계는 정 확히 일치 한 
다 .) 화소가 투명이면(알파요소가 0 이면 ) 현재색묶음의 《기준》색(일반적으로 백색)으로 화소 
를 그리고 그렇지 않으면 화상안의 화소색을 리용한다 . 그다음 QPainter :: fillRectO 을 호출하여 
색으로 채운 바른 4 각형을 그린다 . 살창이 표시되면 바른 4 각형을 량방향으로 1 화소씩 감소하 
여 살창밖에 그리는것을 막는다 . 

( 0 , 0 ) _ 

' 一 ( x . yl 

M W 터 


( widlh ()-1, height ()- 1) 

그림 5-4. QPainter 에 의 한 직 4 각형 그리 기 
QPainten:fillRectO 호출은 다음의 문법을 가전다 . 
painter->fillRect(x, y, w, h, brush)., 

여기서 次넜는 직 4 각형의 왼쪽웃구석의 위치， wx/z 는 직 4 각형의 크기이고 brush 는 채우려 
는 색과 사용하려는 도색견본을 지정한다 . 솔로서 QColor 를 넘기 여 솔리드도색견본을 얻는다 . 
void IconEditor::mousePressEvent(QMouseEvent *event) 

{ 

if (event->button() = LeflButton) 

setImagePixel(event->pos(), true); 
else if (event->button() == RightButton) 
setImagePixel(event->pos(), false); 

} 

사용자가 마우스단추를 누를 때 체계는 《 마우스누르기》사건을 생성한다 . QWidget:: 
mousePressEvent () 를 재정의하여 사건에 응답할수 있으며 마우스유표밑의 화상화소를 설정하 
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거나 지울수 있다. 

사용자가 왼쪽 마우스단추를 찰칵하면 둘째 인수를 true 로 하여 비공개함수 
setImagePixel() 를 호출함으로써 화소를 현재 펜 색으로 설정한다. 사용자가 오른쪽 마우스단추를 
찰칵하면 역시 setlmagePixelO 를 호출하지만 false 를 넘기여 화소를 지운다. 

void IconEditor::mouseMoveEvent(QMouseEvent *event) 

{ 

if (event->state() & LeftButton) 

setImagePixel(event->pos(), true); 

else if (event->state() & RightButton) 
setImagePixel(event->pos(), false); 

} 

mouseMoveEvent() 는《마우스이 동》사건들을 처 리 한다. 기 정 으로 이 사건들은 사용자가 단 
추를 누르고있을 때에만 생성된다. QWidget:setMouseTracking() 를 호출하여 이 동작을 변경할 
수 있으나 이 실례에서는 그럴 필요가 없다. 

왼쪽 혹은 오른쪽 마우스단추를 눌러서 화소를 설정하거나 지운다. 이때 단추를 누른 상 
태에서 화소를 끌고다니는 방법으로 화소를 설정하거나 지운다. 한번에 단추와 여러개의 건 
을 누를수 있으므로 QMouseEvent : state() 가 돌려준 값은 마우스단추들(및 Shift 와 Ctrl 과 같은 
수식건)의 비트별 OR 이다. &연산자를 리용하여 어느 단추를 늘렀는가 검사하고 단추를 눌렀으 
면 setImagePixel() 를 호출한다. 

void IconEditor :: setImagePixel(const QPoint &pos, bool opaque) 

{ 

int i = pos.x() / zoom; 

int j = pos.y() / zoom; 
if (image.rect().contains(i, j)) { 
if (opaque) 

image.setPixel(i, j, penColor().rgb()); 

else 

image.setPixel(i, j, qRgba(0, 0, 0, 0)); 

QPainter painter(this); drawImagePixel(&painter, i, j); 

} 

} 

setImagePixel() 함수는 mousePressEvent() 와 mouseMoveEvent() 로부터 호출되고 화소를 설정 
하거 나 지 운다. pos 파라메 터 는 창문부품에 서 마우스위 치 이 다. 

첫 단계는 마우스위 치 를 창문부품자리표로부터 화상자리표로 변환하는것 이 다. 이 것은 마 
우스위치의 : c 와 ；;요소들을 zoom 곁수로 나누어 수행한다. 다음에 점이 정확히 범위안에 있는 
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가 검사한다 . 검사는 QImage::rect () 와 QRect::contains () 에 의해 쉽게 진행되는메 이때 오가 0 과 
image.width()- 1 사이에 , j 는 0 과 image.height()- 1 사이에 있는가 검사한다 . 

opaque 파라메터에 따라 화상의 화소를 설정하거나 지운다 . 화소의 지우기는 실제로 화소 
를 투명 으로 설정한다 . 끝으로 drawImagePixel () 를 호출하여 변경 된 개 별적 인 화소를 다시 그 
린다 . 

성원함수들을 고찰하였으므로 구성자에서 사용한 WStaticContents 기발에 대하여 보자 . 이 
기발은 Qt 에 창문부품의 크기가 달라질 때 창문부품의 내용이 달라지지 않으며 그 내용은 창 
문부품의 왼쪽웃구석 에 고착된 다는것 을 의 미한다 . Qt 는 이 정 보를 리 용하여 창문부품크기 가 
달라질 때 이 미 표시되 여있는 구역을 필요없이 다시 그리는것을 피 한다 . 

보통 창문부품크기가 변경될 때 Qt 는 창문부품의 전체 보임구역에 대하여 그리기사건을 
생 성 한다 . 그러 나 창문부품을 WStaticContents 기 발을 리 용하여 창조하면 그러 기 사건의 령 역 
(region ) 은 이전에 표시되지 않은 화소들로 제한된다 . 창문부품의 크기가 더 작은 크기로 조절 
되면 그리 기사건은 전혀 생성되 지 않는다 . _ _ 

l ； 혈 ] —j 합 j 

그림 5-5. WStaticContents 창문부품의 크기 조절 

이제는 IconEditor 창문부품이 완성되였다 . 앞장들의 정보와 실례들을 사용하여 IconEditor 를 
자체 의 창문으로， QMainWindow 의 중심 창문부품으로，배 치 관리 자안의 자식 창문부품으로서，혹 
은 QScrollView 안의 자식 창문부품으로서 사용하는 코드를 쓸수 있다 . 다음 절 에서는 이 것을 
Qt Designer 에 통합하는 방법을 알게 된다 . 

제3절. 사용자정의창문부품을 Qt Designer 와 통합하기 

Qt Designer 에 서 사용자정 의 창문부품을 사용하려 면 Qt Designer 가 그것 을 알고있 어 야 한다 . 
이것을 수행하는 수법 에는 2 가지 즉《단순한 사용자정 의창문부품》수법 과 플라그인수법 이 있 
다 . 

단순한 사용자정 의창문부품수법 은 Qt Designer 에 서 대 화칸을 사용자정 의창문부품에 대 한 
정보로 채우는것으로 시작한다 . 그다음 창문부품은 Qt Designer 를 리용하여 개발한 폼들에서 
사용할수 있으나 그 창문부품은 폼을 편집하거나 미리보기하는동안 그림기호와 어두운 재색 
의 직 4 각형으로만 표시된다 . 여기에 이 수법으로 HexSpinBox 창문부품을 통합하는 방법이 있 
다 . 

① Tools|Custom|Edit Custom Widget 를 찰칵하여 Qt Designer 의 사용자정 의 창문부품편집 기 를 
펼친다 . 

② NewWidget 를 찰칵한다 . 
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③ 클라스이 름을 MyCustomWidget 로부터 HexSpinBox 로 변 경 하고 머 리 부파일 을 

mycustomwidget 上로부터 hexspinbox.h 로 변경한다 . 

④ 크기암시 를 (60, 20) 으로 변 경 한다 . 

⑤ 크기 방략을 (Minimum, Fixed) 로 변 경 한다 . 

그다음 창문부품은 Qt Designer 도구칸의 Custom Wigets 부분에서 사용할수 있 다 . 


Edit Custom Widgets 1 @ 
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그림 5-6. Qt Designer 의 사용자정 의 창문부품편 집 기 
플라그인수법은 Qt Designer 가 실행시에 적재하고 창문부품의 실례들을 창조하는데 사용 
할수 있는 플라그인서고의 창조를 요구한다 . 실제창문부품은 그다음 폼을 편집하고 미리보기 
할 때 Qt Designer 에 의해 사용된다 . IconEditor 을 플라그인으로서 통합하고 그 동작을 보여준 
다 . 

우선 QWidgetPlugin 의 파생클라스를 만들고 일부 가상함수들을 재정의한다 . 같은 원천파 
일에서 모든것을 수행한다 . 플라그인원천코드는 iconeditorplugin 이라는 등록부에 배치하고 
IconEditor 원 천 코드는 iconeditor 라는 등록부에 배 치한다 . 

여기에 머리부파일이 있다 . 

#include <qwidgetplugin.h> 

#include ". ./iconeditor/iconeditorh" 
class IconEditorPlugin : public QWidgetPlugin 
{ 

public: 

QStringList keys() const; 
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QWidget *create(const QString &key, QWidget ^parent, const char *name); 

QString includeFile(const QString &key) const; 

QString group(const QString &key) const; 

QlconSet iconSet(const QString &key) const; 

QString toolTip(const QString &key) const; 

QString whatsThis(const QString &key) const; 
bool isContainer(const QString &key) const; 

}； 

IconEditorPlugin 의 파생 클라스는 IconEditor 창문부품을 밀봉하는 factory 클라스이다 . 함수들 
은 Qt Designer 에 의하여 클라스의 실례들을 창조하고 그에 대한 정보를 엄는데 사용된다 . 
QStringList IconEditorPlugin: : keys() const 
{ 

return QStringList()« "IconEditor"; 

} 

keysO 함수는 풀라그인 에 의해 제 공된 창문부품들의 목록을 돌려 준다 . 실 례 를라그인 은 오 
직 IconEditor 창문부품만 제공한다 . 

QWidget * IconEditorPlugin: :create(const QString &, QWidget *parent, const char *name) 

{ 

return new IconEditor(parent, name); 

} 

create() 함수는 Qt Designer 에 의해 호출되고 창문부품클라스의 실례를 창조한다 . 첫 인수는 
창문부품의 클라스이 름이 다 . 이 실례 에서 는 한개 클라스만 제공하므로 그것을 무시할수 있다 . 
다른 함수들도 첫 인수로서 클라스이름을 가진다 . 

QString IconEditorPlugin: :includeFile(const QString &) const 

{ 

return "iconeditor.h"; 

} 

indudeFileG 함수는 플라그인에 의해 밀봉된 지정된 창문부품의 머리부파일이름을 돌려준 
다 . 머 리부파일은 uic 도구로 생성한 코드에 포함된다 . 

bool IconEditorPlugin::isContainer(const QString &) const 

{ 

return false; 

} 

isContainerO 함수는 창문부품이 다른 창문부품들을 포함하면 true 를 돌려주고 그렇지 않으 
면 false 를 돌려준다 . 례를 들면 QFrame 은 다른 창문부품들을 포함하는 창문부품이다 . 
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IconEditor 가 다른 창문부품들을 포함할 필요가 없으므로 false 를 돌려준다 . 엄격히 말해서 창 
문부품은 다른 창문부품들을 포함할수 있으나 Qt Designer 는 isContainer() 가 false 를 돌려줄 때 
이것을 허용하지 않는다 . 

QString IconEditorPlugin: : group(const QString &) const 

{ 

return "Plugin Widgets"; 

} 

groupG 함수는 이 사용자정 의창문부품이 속하는 도구칸그룹의 이 름을 돌려 준다 . 이 름을 이 
미 사용하고있으면 Qt Designer 가 자동적 으로 그 창문부품용의 새 그룹을 창조한다 . 

QlconSet IconEditorPlugin: : iconSet(const QString &) const 

{ 

return QIconSet(QPixmap::fromMimeSource("iconeditor.png")); 

} 

iconSetO 함수는 Qt Designer 의 도구칸에서 사용자정 의 창문부품을 표시 하는데 쓰이 는 그림 
기호를 돌려준다 . 

QString IconEditorPlugin: : toolTip(const QString &) const 

{ 

return "Icon Editor"; 

} 

toolTipO 함수는 마우스가 Qt Designer 도구칸에 서 사용자정 의 창문부품을 가리 킬 때 표시 하 
려는 도구암시를 돌려준다 . 

QString IconEditorPlugin: : whatsThis(const QString &) const 

{ 

return "Widget for creating and editing icons"; 

} 

whatsThis() 함수는 Qt Designer 가 현시하게 될 What’s This? 본문을 돌려준다 . 
Q_EXPORT_PLUGIN(IconEditorPlugin) 

플라그인클라스를 실현하는 원천파일의 끝에서 Q_EXPORT_PLUCnN0 마크로에 의하여 플 
라그인 을 Qt Designer 에 서 사용할수 있 게 한다 . 

플라그인을 구축하기 위한 .pro 파일은 다음과 갈다 . 

TEMPLATE = lib 

CONFIG += plugin 

HEADERS = . ./iconeditor/iconeditor.h 

SOURCES = iconeditorplugin.cpp \ 

. ./iconeditor/iconeditor.cpp 
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IMAGES = images/iconeditor.png 
DESTDIR = $(QTDIR)/plugins/designer 

.pro 파일은 QTE«R 환경 변수가 어를 설치 한 등록부로 설정 된것으로 가정 한다 . make 혹은 
nmake 에 의하여 플라그인을 구축할 때 Qt Designer 의 plugins 등록부에 자동적으로 그것을 설치 
한다 . 

플라그인을 구축하면 IconEditor 창문부품을 Qt Designer 에 서 (가의 기 본창문부품들처 럼 사용 
할수 있다 . 


제4절. 2중완충 

2 중완충 (double buffering ) 은 활기 있는 사용자대 면부를 제 공하고 깜빡거 림 을 제 거 하는데 사 
용할수 있는 기 술이 다 . 깜빡거 림 은 아주 짧은 시 간동안에 같은 화소를 여 러 번 각이한 색 으로 
그릴 때 발생한다 . 깜빡거림이 오직 한 화소에서 발생하면 문제가 없지만 동시에 여러 화소 
들에서 발생하면 사용자를 혼란시킨다 . 

아가 그리 기사건을 생성할 때 우선 창문부품을 조색 판의 배경색으로 지 운다 . 그다음 창문 
부품은 paintEventO 에서 배 경색과 갈지 않은 화소만 그릴 필요가 있다 . 이 2 단계수법 은 창문 
부품에 서 오직 필요한 화소들만 그리 고 다른 화소들을 고찰하지 않는다는것 을 의 미한다 . 

또한 2 단계수법은 깜빡거림의 주요한 원천이다 . 례를 들면 사용자가 창문부품크기를 조절 
하면 창문부품은 우선 그 자체를 모두 지우고 화소들을 그린다 . 깜빡거림은 창문내용의 크기 
가 달라질 때 창문체계가 창문부품을 반복하여 지우고 그러므로 심해진다 . 

피 £憂】 邊 S 

그림 5-7. 깜빡거 림 을 제 거 하지 않은 창문부품의 크기변 경 

IconEditor 창문부품을 실현하는데 사용한 WStaticContents 기발은 이 문제에 대한 하나의 헤 
결책이지만 내용이 창문부품의 크기에의존하지 않는 창문부품들에만 쓰일수 있다 . 그러한 창 
문부품은 드물다 . 대부분의 창문부품들은 모든 유효공간을 차지하도록 자기 내용을 늘일수 
있다 . 또한 크기 를 조절할 때 완전히 다시 그려야 한다 . 깜빡거 림을 피할수 있으나 해 결책은 
훨씬 더 복잡하다 . 

깜빡거 림을 피하는 첫째 규칙은 WNoAutoErase 기발을 리용하여 창문부품을 구성하는것이 
다 . 이 기발은 어에 그리기사건에 앞서 창문부품을 지우지 말라고 알려준다 . 그러면 낡은 화 
소가 변경되지 않은대로 남아있고 새로 나타난 화소들은 정의되지 않는다 . 
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그림 5-8. WNoAutoErase 창문부품의 크기 변경 

WNoAutoErase 을 사용할 때 그리기처리함수가 모든 화소들을 명시적으로 설정하는것이 
중요하다 . 그러기사건에서 설정되지 않은 화소는 배경색을 요구하지 않는 이전의 값을 보유 
한다 . 

깜빡거림을 피하는 둘째 규칙은 모든 화소들을 한번만 그리는것이다 . 이 요구를 실현하는 
가장 간단한 방법은 화면밖의 픽스매프에 전체 창문부품을 그리고 그 픽스매프를 창문부품에 
단번에 복사하는것이다 . 이 수법을 리용하면 그리기가 화면밖에서 수행되므로 화소들이 여러 
번 그려져도 문제가 없다 . 이것이 2 중완충이다 . 

깜빡거 림 을 소거하기 위 하여 사용자정 의창문부품에 2 중완충기 능을 추가하는것 은 간단하 
다 . 원래의 그리 기 사건처 리함수가 다음과 같다고 가정 하자 . 

void My Widget :: paintEvent(QPaintEvent *) 

{ 

QPainter painter(this); 
drawMyStuff(&painter); 

} 

2 중완충판은 다음과 같다 . 

void My Widget :: paintEvent(QPaintEvent * event) 

{ 

static QPixmap pixmap; 

QRect rect = event->rect(); 

QSize newSize = rect.size().expandedTo(pixmap.size()); 

pixmap.resize(newSize); 

pixmap.fill(this, rect.topLeft()); 

QPainter painter (&pixmap, this); 
painter.translate(-rect.x(), -rect.y()); 
drawMyStuff(&painter); 

bitBlt(this, rect.x(), rect.y(), &pixmap, 0, 0, rect.width(), rect.height()); 

} 

우선 QPixmap 의 크기를 변경하여 적 어도 다시 그리려는 령역 이나 경계직 4 각형의 크기로 
만든다 . ( 령역 (region ) 은 흔히 직 4 각형이나 L 형구역이지만 그것들의 임의의 결합일수 있다 .) 
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QPixmap 를 정 적변수로 만들어 거기 에 반복하여 기 억기를 할당하고 해제하는것을 피 한다 . 같 
은 리유로 QPixmap 를 절대로 줄이지 않으며 QSize::expandedTo () 와 QPixmap::resize () 의 호출은 
그것 이 늘 충분한 크기 라는것 을 담보한다 . 크기변 경 후에 QPixmap :: fill () 에 의 하여 QPixmap 를 
창문부품의 지우개색 혹은 배경픽스매프로 채운다 . 의 둘째 인수는 QPixmap 의 제 일 웃준 

위화소가 창문부품의 어느 점 에 대응하는가를 지 정한다 . (갈은 색대신에 픽스매프를 리용하여 
창문부품을 지운다면 차이나게 된다 .:) 

QPixmap 클라스는 Qlmage 와 비숫하고 QWidget 와도 비숫하다 . Qlmage 처럼 화상을 보관하 
지 만 색 깊 이 와 가능하다면 색 변환을 가진 은폐 된 QWidget 처 럼 현시 기 에 배 치한다 . 창문체계 
가 8bit 방식으로 실행되고있으면 모든 창문부품과 픽스매프들이 256 색으로 제한되고 Qt 는 자 
동적으로 24bit 색명세를 8bit 색들로 변환한다 . (Qt 의 색할당전략은 QApplication::setColorSpec()3l 
출에 의해 조종된다 .) 

다음으로 QPainter 를 창조하여 픽스매프에 조작한다 . 이 지적자를 구성자에 넘기여 
QPainter 가 창문부품들의 서체와 같은 설정을 받아들이게 한다 . 보통과 같이 QPainter 를 리용 
하여 그리 기전에 painter 가 정 확한 직 4 각형 을 픽 스매프에 그리 도록 변환한다 . 

끝으로 bitBltO 대 역함수에 의해 창문부품에 픽스매프를 복사한다 . 이 함수의 이름은 비트 
블로크전 송 (bit-block transfer ) 으로부터 유래된 것이다 . 

2 중완충은 깜빡거림을 피하는데만 사용할수 있는것이 아니다 . 창문부품의 그리기가 복잡 
하고 반복이 요구된다면 2 중완충이 유익하다 . 그때 창문부품을 리용하여 픽스매프를 디스크 
에 보관할수 있다 . 즉 항상 다음의 그리기사건을 받을 준비를 하고있다가 그리기사건을 받을 
때마다 픽스매프를 창문부품에 복사한다 . 이것은 전체 창문부품의 묘사를 반복하여 계산하지 
않고 선택창을 그리는것과 같이 약간 수정하려고 하는 경우에 특별히 유익한 수법이다 . 

Plotter 사용자정 의창문부품을 고찰하는것 으로 이 장을 끝낸 다 . 이 창문부품은 2 중완충을 
사용하며 건반사건처리，수동배치，자리표계와 같은 Qt 프로그람작성의 다른 국면들도 보여준 
다 . 

Plotter 창문부품은 자리표값들의 백토르로서 지정된 하나이상의 곡선을 현시한다 . 사용자 
는 화상우에 선 택창을 그리 고 Plotter 는 선 택 창안에 들어있는 구역안에서 확대 한다 . 사용자는 
그라프우의 한 점을 찰칵하고 마우스의 왼쪽단추를 누르면서 다른 위치로 끌고가서 마우스의 
단추를 놓는 방법 으로 선 택창을 그린 다 . 
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그림 5-9. Plotter 창문부품에 서 확대 하기 


사용자가 Zoom Out 단추를 리용하여 축소하고 Zoom In 단추에 의하여 다시 확대하여 선택 
창을 여러번 그리는 방법으로 반복하여 확대한다 . Zoom In 과 Zoom Out 단추들은 그것들을 처음 
으로 사용하는 경우에 나타난다 . 

Plotter 창문부품은 임의의 수의 곡선들에 대한 자료를 보관할수 있다 . 또한 매개 요소가 
특별한 확대준위 에 대응하는 PlotSettings 의 탄창을 보관한다 . 
plotter.h 로부터 시작하여 클라스를 고찰하자 . 

#ifndef PLOTTER_H 
#define PLOTTER_H 
#include <qpixmap.h> 

#include <qwidget.h> 

#include <map> 

#include <vector> 
class QToolButton; 
class PlotSettings; 

typedef std: : vector<double> CurveData; 

표준 < 111 &1 )>와 <vector > 머 리부파일을 포함한다 . std 이름공간의 모든 기호들을 대 역이름공간 
에로 반입하지 않는다 . 그것은 머리부파일에서 그렇게 하는것은 나른 형식이기때문이다 . 

CurveData 를 std::vector<double > 의 동의어로 정의한다 . 곡선의 점들을 벡토르에 义와 기값들 
의 련속쌍으로 보관한다 . 례를 들면 점 (0, 24) ， (1 ， 44) ， (2,89 )들에 의 해 정의된 곡선은 벡토르 [0, 
24, 1,44,2, 89 ] 로 표시 된 다 . 

class Plotter : public QWidget 

{ 

Q_OBJECT 

public: 

Plotter(QWidget ^parent = 0, const char *name = 0, WFlags flags = 0); 

void setPlotSettings(const PlotSettings &settings); 
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void setCurveData(int id, const CurveData &data); 
void clearCurve(int id); 

QSize minimumSizeHint() const; 

QSize sizeHint() const; 
public slots: 

void zoomIn(); 
void zoomOut(); 

도면 (plot ) 을 설 정 하는 3 개 의 공개 함수들과 확대 와 축소를 위한 2 개 의 공개 처 리 부를 제 공 
한다 . 또한 QWidget 로부터 minimumSizeHint () 와 sizeHint () 를 재 정 의 한다 . 
protected: 

void paintEvent(QPaintEvent *event); 
void resizeEvent(QResizeEvent * event); 
void mousePressEvent(QMouseEvent *event); 
void mouseMoveEvent(QMouseEvent * event); 
void mouseReleaseEvent(QMouseEvent *event); 
void keyPressEvent(QKeyEvent * event); 
void wheelEvent(QWheelEvent *event); 

클라스의 보호부에서 재정의해 야 할 QWidget 사건처 리함수들을 모두 선언한다 . 
private: 

void updateRubberBandRegion(); 
void refreshPixmap(); 
void drawGrid(QPainter *painter); 
void drawCurves(QPainter *painter); 
enum { Margin = 40 }; 

QToolButton *zoomInButton; 

QToolButton *zoomOutButton; 
std::map<int, CurveData> curveMap; 
std :: vector<PlotS ettings 〉 zoomStack; 
int curZoom; 
bool rubberBandlsShown; 

QRect rubberBandRect; 

QPixmap pixmap; 

}； 

클라스의 비공개부에서 하나의 상수，창문부품을 그리는 여러개의 함수들，여러개의 성원 
변수들을 선언한다 . Margin 상수는 그라프주위 에 공간을 제공하는데 쓰인다 . 
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성원변수들중에는 QPixmap 형의 pixmap 가 있다 . 이 변수는 화면에 표시되는것과 등가한 
전체 창문부품의 그림의 사본을 보관한다 . 도면은 늘 우선 화면밖의 픽스매프에 그려지고 그 
다음 픽스매프가 창문부품에 복사된다 . 


class PlotSettings 

{ 

public: 

PlotSettings(); 

void scroll(int dx, int dy); 

void adjust(); 

double spanX() const { return maxX -minX; } 
double spanY() const { return maxY -minY; } 
double minX; 
double maxX; 
int numXTicks; 
double minY; 
double maxY; 
int numYTicks; 
private: 

void adjustAxis(double &min, double &max, int &numTicks); 

}； 

#endif 

PlotSettings 클라스는 x 와 기축의 범위와 이 축들의 눈금수를 지 정 한다 . 그림 5-10 은 
PlotSettings 객체와 Plotter 창문부품상에서 눈금들사이의 대응관계를 보여 준다 . 


maxY 


minY 

minX reaxX 



T I r 


그림 5-10. PlotSettings 의 성 원변수 

편리상 numXTicks 와 numYTicks 는 하나씩 차이난다 . 즉 numXTicks 이 5 이 면 Plotter 는 실제 





로 x 축우에 6 단위의 표식을 그린다 . 이것은 후에 계산을 단순화한다 . 

그러면 실현파일을 고찰하자 . 

#include <qpainter.h> 

#include <qstyle.h> 

#include <qtoolbutton.h> 

#include <cmath> 
using namespace std; 

#include ’’plotter.h” 

기대한 머 리부파일들을 포함하고 std 이름공간의 기호들을 모두 대 역이름공간에 반입한다 . 
Plotter: :Plotter(QWidget ^parent, const char *name, WFlags flags) 

: QWidget(parent, name, flags | WNoAutoErase) 

{ 

setBackgroundMode(PaletteDark); 

setSizePolicy(QSizePolicy: : Expanding, QSizePolicy: : Expanding); 

setFocusPolicy(StrongFocus); 

rubberB andls Shown = false; 

zoomlnButton = new QToolButton(this); 

zoomInButton->setIconSet(QPixmap::fromMimeSource( n zoomin.png")); 

zoomInButton->adjustSize(); 

connect(zoomInButton, SIGNAL(clicked()), this, SLOT(zoomIn())); 
zoomOutButton = new QToolButton(this); 

zoomOutButton->setIconSet( QPixmap :: fromMimeSource("zoomout.png”)); 
zoomOutButton->adjustSize(); 

connect(zoomOutButton, SIGNAL(clicked()), this, SLOT(zoomOut())); 
setPlotSettings(PlotSetting()); 

} 

Plotter 는 parent 와 name 과 함께 flags 파라메터를 가지고있다 . 이 과라메터는 기초클라스구 
성자에 WNoAutoErase 와 함께 넘긴다 . 이 파라메터는 클라스의 사용자들이 창문틀과 제목띠를 
구성할수 있게 하므로 독자적 인 창문으로 쓰이는 창문부품들에 특히 쓸모있다 . 

setBackgroundMode () 호출은 QWidget 에 게 창문부품을 지 우기 위한 색 으로서 조색 판의 《어 
두운》요소를《배경》요소대신에 사용하게 한다 . 기초클라스 구성자에 WNoAutoErase 기발을 넘 
기지만 Qt 는 창문부품의 크기가 커질 때 paintEvent () 가 새 화소들을 그릴 기회를 얻기 전에 
새로 로출된 화소들을 채우는데 사용할수 있는 기정색을 여전히 요구한다 . Plotter 창문부품의 
배경 이 어두운 색이므로 이 화소들을 어두운 색으로 그리게 하는것 이 상식 이 다 . 

setSizePolicy () 호출은 창문부품의 크기방략을 량방향에서 QSizePolicy :: Expanding5. 설정 한 
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다. 이것은 창문부품에 응답할수 있는 배치관리자에게 창문부품을 특별히 늘일 결심이지만 
줄일수도 있다는것을 알린다. 이 설정은 많은 화면공간을 차지하는 창문부품들에 전형적이다. 
기 정값은 량방향에서 QSizePolicy :: Preferred 로서 창문부품이 크기암시의 크기로 선택되지만 최 
소크기암시까지 줄이거나 필요하다면 무한정 늘일수 있다는것을 의미한다. 

seffocusPolicyO 호출은 마우스를 찰칵하거 나 Tab 를 눌러 서 창문부품이 초점 을 받아들이 게 
한다. Plotter 가 초점을 가질 때 건누르기사건들을 받아들인다. Plotter 창문부품은 몇가지 건들을 
인식한다. 즉 +는 확대，-는 축소, 화살건들은 올리, 내 리, 왼쪽, 오른쪽 흘림 . 



그림 5-11. Plotter 창문부품의 흘림 

여전히 구성자에서는 그림기호를 가지는 두개의 QToolButton 을 창조한다. 이 단추들은 사 
용자가 zoomStack 를 항행하게 한다. 단추의 그림기호들은 화상집합에 보관된다. Plotter 창문부 
품을 사용하는 응용프로그람은 자기의 .pro 파일에 항목을 요구한다. 

IMAGES += images / zoomin.png \ images / zoomout.png 
단추들에 대 하여 adjustSize () 를 호출하면 단추들의 크기 를 크기암시 의 크기 로 설 정 한다. 
마감에 setPlotSettings () 의 호출은 초기화의 나머지 작업을 수행한다. 
void Plotter : : setPlotSettings(const PlotSettings & settings ) 

{ 

zoomStack . resize ( 1); 
zoomStack [0] = settings ; 
curZoom = 0; 
zoomInButton -> hide (); 
zoomOutButton -> hide (); 
refreshPixmap (); 

} 

setPlotSettingsO 함수는 도면을 현시 하는데 쓰이 는 PlotSettings 을 지 정한다. 이 함수는 
Plotter 구성자에서 호출되고 클라스의 사용자들에 의해 호출될수 있다. Plotter 는 기정확대준위 
에서 시작한다. 사용자가 확대 할 때마다 새로운 PlotSettings 실례가 창조되여 zoomStack 에 넣어 
진 다. 
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zoomStack 는 2 개의 성원변수들로 표시된다. 

• zoomStack 는 각이 한 확대 축소설 정 들을 꾸예1：01'<?1(^861선11은8>로서 보관한다. 

• curZoom 은 zoomStack 에서 현재 PkrtSettings 의 첨 수를 보관한다. 

setPlotSettings () 호출후에 zoomStack 는 오직 하나의 항목을 포함하고 Zoom In 과 Zoom Out 단 
추들은 숨겨 진 다. 이 단추들은 zooming 과 zoomOutO 처 리 부들에 서 그것 들에 대 하여 showO 를 
호출할 때 까지 표시 되 지 않는다. (보통 제 일 웃준위 창문부품에 대 하여 show () 를 호출하여 자식 
들을 모두 표시 하는것으로 충분하다. 그러 나 자식창문부품에 대하여 명시 적 으로 hide () 를 호출 
한 다음 show () 를 호출할 때 까지 그것 은 은폐 되 여있 다.) 

refreshPixmapO 호출은 현시를 갱신하는데 필요하다. 보통 update () 를 호출하군 하지만 여기 
서는 언제나 최신식으로 QPixmap 를 유지하려고 하므로 현저히 다른 일을 수행한다. 픽스매프 
를 다시 생성한 후에 refreshPixmapO 는 update () 를 호출하여 적스매프를 창문부품에 보관한다. 
void Plotter : : zoomOut () 

{ 

if (curZoom > 0) { 



zoomOutButton -> setEnabled(curZoom > 0); 
zoomInButton -> setEnabled ( true ); 
zoomInButton -> show (); 
refreshPixmapO ; 

} 

} 

zoomOut () 처리부는 그라프가 확대되면 축소한다. 이것은 현재의 확대준위를 감소시키고 
그라프를 더 축소할수 있는가 없는가에 따라서 Zoom Out 단추를 허 용한다. Zoom In 단추가 허 용 
되 여 표시되고 현시는 torefreshPixmap () 호출과 함께 갱신된다. 
void Plotter : : zoomIn () 

{ 

if (curZoom > ( int ) zoomStack . size () -1) { 



zoomInButton -> setEnabled(curZoom < ( int ) zoomStack . size () -1); 

zoomOutButton -> setEnabled ( true ); 

zoomOutButton -> show (); 

refreshPixmapO ; 

} 

} 

사용자가 이전에 확대하였다가 다시 축소하면 다음 확대준위를 위한 PlotSettings 는 
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zoomStack 에 있게 되고 확대할수 있다. (그렇지 않으면 선택창에 의하여 아직도 확대할수 있 
다.) 

이 처리부는 curZoom 을 증가시켜 zoomStack 에로 1준위 더 깊이 들어가고 좀 더 확대할수 
있는가에 따라서 Zoom In 단추를 허 용이 나 금지 로 설정 하고 Zoom Out 단추를 허 용하고 표시 한 
다. 다시 refreshPixmapO 를 호출하여 Plotter 가 최근의 확대설정을 사용할수 있게 한다. 
void Plotter : : setCurveData(int id , const CurveData & data ) 

{ 

curveMap [ id ] = data ; 

refreshPixmap (); 

} 

setCurveData () 함수는 주어진 正)의 곡선자료를 설정한다. 같은 ID 를 가지는 곡선이 Plotter 
에 이미 존재한다면 그것은 새로운 곡선자료로 교체되며 그렇지 않으면 새 곡선은 그저 삽입 
된다. 곡선들은 map < int , CurveData > 형 의 curveMap 성 원변수에 보관된다. 

다시 update () 가 아니라 자체의 refreshPixmapO 함수를 호출하여 현시를 갱신한다. 
void Plotter : : clearCurve(int id ) 

{ 

curveMap . erase ( id ); 

refreshPixmapO ; 

} 

clearCurveO 함수는 curveMap 에서 하나의 곡선을 지운다. 

QSize Plotter : : minimumSizeHint () const 

{ 

return QSize (4 * Margin , 4 * Margin ); 

} 

minimumSizeHint () 함수는 sizeHint () 와 비숫하며 sizeHint () 가 창문부품의 리 상크기를 지정 하 
듯이 minimumSizeHint () 는 창문부품의 리 상적 인 최 소크기 를 지 정 한다. 배 치 관리 자는 결코 창 
문부품의 크기 를 최 소크기암시 이 하로 줄이 지 않는다. 

돌려주는 값은 160 x 160 으로서 4개의 모든 변에 여백과 도면자체에 공간을 허용한다. 그 
크기 이하이면 도면은 사용하기 에는 너무 작다. 

QSize Plotter : : sizeHint () const 

{ 

return QSize (8 * Margin , 6 * Margin ); 

} 

sizeHint () 에서는 여백에 비례하고 4:3 의 가로세로비를 가지는 《리상》크기를 돌려준다. 
이로서 Plotter 의 공개함수들과 처리부들의 설명을 끝낸다. 이제는 보호사건처리함수들을 



고찰한다 . 

void Plotter: : paintEvent(QPaintEvent *event) 

{ 

QMemArray<QRect> rects = event->region().rects(); 

for (int i = 0; i < (int)rects.size(); ++i) 

bitBlt(this, rects[i].topLeft(), &pixmap, rects[i]); 

QPainter painter(this); 

if (rubberBandlsShown) { 

painter.setPen(colorGroup().light()); 

painter.drawRect(rubberBandRect.normalize()); 

} 

if (hasFocus()) { 

style().drawPrimitive(QStyle::PE_FocusRect, &painter, rect(), colorGroup(), 

QStyle::Style_FocusAtBorder, colorGroup().dark()); 

} 

} 

보통 paintEventO 는 모든 그리 기 를 수행하는 함수이 다 . 그러 나 여기서 모든 도면그리 기는 
refreshPixmap () 에서 미리 수행되므로 픽스매프를 창문부품에 복사하여 전체 도면을 간단히 표 
시할수 있다 . 

QRegion :: rect () 호출은 다시 그리려는 령역을 정의하는 QRect 들의 배렬을 돌려준다 . bitBlt() 
를 사용하여 적스매프에서 창문부품으로 매개의 직 4 각형 구역 을 복사한다 . bitBlt () 대 역함수는 
다음과 갈은 문법을 가진다 . 

bitBlt(c?e5/, destPos, source, sourceRect); 

여기서 soMrce 는 원천창문부품 혹은 픽스매프， sourceRect 는 복사되여야 할 원천안의 직 4 각 
형,쇼자는 목적창문부품 혹은 픽스매프，쇼대 ftw 는 목적지의 왼쪽웃구석위치 이다 . 

sourceJJect 

m 

soiree 

그림 5-12. 픽스매프와 창문부품들에 대한 임의의 직 4 각형들의 복사 

앞의 코드부분에서 본것처럼 령역의 경계직 4 각형에 대하여 한번만 bitBltO 를 호출하도록 
교정 하였다 . 그러 나 마우스사건 처 리 함수들안에 서 update 。 를 호출하여 선 택 창을 반복하여 지 우 
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고 다시 그리 기 하고 선 택창의 테 두리 선 이 기 본적 으로 4 개 의 작은 직 4 각형 들 (2 개 는 1 화소폭의 
직 4 각형, 두개는 1 화소높이의 직 4 각형들)이므로 령역을 그것을 구성하는 직 4 각형들로 나누고 
매개 직 4 각형에 대하여 bitBlt() 를 호출하여 속도를 엄는다. 

도면이 화면에 표시되면 선택창과 초점직 4 각형을 그 꼭대기에 그린다. 선택창에 대하여 
창문부품의 현재색묶음으로부터 《가벼운》요소를 펜색으로 사용하여 어두운 배경과 잘 대조 
되 도록 한다. 화면 밖의 픽 스매 프에 손을 대 지 않고 직 접 창문부품에 그린 다. 초점직 4 각형 은 
첫 인수로서 PE_FocusRect 를 가지는 창문부품형식의 drawPrimitiveO 함수를 리 용하여 그린다. 

QWidgetxstyleO 함수는 창문부품을 그리는데 사용할 창문부품형식을 돌려 준다. (가에서 창문 
부품형 식 은 QStyle 의 파생 클라스이 다. 내 부형 식 은 QWindowStyle, QWindowsXPStyle, QMotifStyle, 
QMacStyle 을 포함한다. 매개 형식은 QStyle 의 가상함수들을 재정의하여 그 형식이 모의하고있 
는 가동환경에 알맞는 방법으로 그리기를 수행한다. drawPrimitiveO 함수는 이러한 함수들중의 
하나로서 조종판，단추, 초점직 4 각형들과 같은《원시요소》들을 그린다. 창문부품형식은 보통 
한 응용프로그람의 모든 창문부품들에서 같지만 (QApplication::style()) QWidget::setStyle() 에 의 하 
여 각 창문부품의 형식을 다시 설정할수 있다. 

QStyle 의 파생클라스를 만들어서 사용자정의형식을 정의할수 있다. 이 것은 하나의 응용프 
로그람이 나 한조의 응용프로그람들에 독특한 형식을 제공하도록 정의할수 있다. 일반적으로 
목표가동환경 의 원시형식 을 사용할것을 권고하지 만 아는 우수한 유연성 을 제공한다. 

Qt 의 기본창문부품들은 거의 QStyle 에만 기초하여 자체를 그린다. 이것은 기본창문부품들 
이 Qt 에 의해 유지된 모든 가동환경들에서 원시적인 창문부품들처럼 보이기때문이다. 사용자 
정 의창문부품들은 자체 를 그리 는데 QStyle 을 사용하거 나 기 본 Qt 창문부품들을 자식창문부품들 
로서 리용함으로써 형식을 인식할수 있다. Plotter 에서는 두 수법을 모두 사용한다. 즉 초점직 4 
각형 은 QStyle 을 리 용하여 그리 며 Zoom In 과 Zoom Out 단추들은 기 본 Qt 창문부품들이다. 

void Plotter: :resizeEvent(QResizeEvent *) 

{ 

int x = width() - (zoomInButton->width() + zoomOutButton->width() + 10); 
zoomInButton->move(x, 5); 

zoomOutButton->move(x + zoomInButton->width() + 5, 5); 
refreshPixmap(); 

} 

Plotter 창문부품의 크기 가 변할 때 (가는《크기변경》사건을 생성한다. 여기서는 resizeEvent() 
를 재 정 의 하여 Plotter 창문부품의 오른쪽 우에 Zoom In 과 Zoom Out 단추들을 배 치한다. 

Zoom In 단추와 Zoom Out 단추들을 옮기 여 나란히 놓는다. 이때 5 화소간격으로 갈라놓고 
우에서 5 화소 내러와서 부모창문부품의 오른변에 놓는다. 

단추들을 자리표가 (0, 0) 인 왼쪽웃구석 에 놓으러고 하는 경우 Plotter 구성자에서 단추들을 
간단히 옳긴다. 그러나 오른쪽 웃구석에 유지하려고 하는 경우에 그 자리표들은 창문부품의 
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크기 에 의 존한다 . 이 리 하여 resizeEventO 를 재 정 의 하고 거 기 서 위 치 를 설 정 하는것 이 필 요하다 . 

Plotter 구성자에서 단추들의 위치를 설정하지 않는다 . 이것은 Qt 가 항상 창문부품이 처음 
으로 표시되기전에 크기조절사건을 생성하므로 본질은 아니다 . 

resizeEvent() 를 재 정의 하고 자식 창문부품들을 수동으로 배치하는 다른 방법 은 배치관리 자 
(례 를 들면 QGridLayout) 를 사용하는것 이 다 . 그러 나 좀 더 복잡하고 더 많은 자원 을 소비한다 . 
여 기서 하는것 처 럼 창문부품들을 새로 작성할 때 자식창문부품들의 수동배치 는 보통 옳은 수 
법이다 . 

끝으로 refreshPixmapO 를 호출하여 픽스매프를 새로운 크기로 다시 그린다 . 

void Plotter: :mousePressEvent(QMouseEvent *event) 

{ 

if (event->button() == LeflButton) { 
rubberBandlsShown = true; 
rubberBandRect.setTopLefl(event->pos()); 
rubberBandRect.setBottomRight(event->pos()); 
updateRubberBandRegion(); 
setCursor(crossCursor); 

} 

} 

사용자가 왼쪽 마우스단추를 찰칵할 때 선택창의 현시를 시작한다 . 이것은 
rubberBandlsShown 를 true 로 설정하고 rubberBandRect 성원 변수를 현재 마우스유표위치로 초기화 
하며 선택창을 그리도록 그리기사건을 발생시키고 마우스유표를 +형으로 변경하는 과정을 포 
함한다 . 

Qt 는 마우스유표의 형태를 조종하는 2 가지 기구를 제공한다 . 

• QWidget :: setCur SOr () 는 마우스가 특별한 창문부품의 우로 지날 때 사용하려는 유표형태를 
설정한다 . 창문부품에 유표가 설정되 지 않으면 부모창문부품의 유표가 사용된다 . 제 일 웃준위 
창문부품들의 기 정 유표는 화살유표이다 . 

- QApplication::setOverrideCursor()^ 전체 응용프로그람용의 유표형 태 를 설 정한다 . 이 때 
restoreOverrideCursor() 가 호출될 때까지 개별적인 창문부품들에 의하여 설정된 유표들은 무시 
된 다 . 

4 장에서는 waitCursor 을 가지고 QApplication::setOverrideCursor() 를 호출하여 응용프로그람 
의 유표를 표준기다림유표로 변경하였다 . 

void Plotter: :mouseMoveEvent(QMouseEvent * event) 

{ 


if (event->state() & LeftButton) { 
updateRubberBandRegion(); 
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rubberBandRect.setBottomRight(event->pos()); 

updateRubberBandRegion(); 

} 

} 

사용자가 왼쪽단추를 누른 상태에서 마우스유표를 옮길 때 updateRubberBandRegion() 를 호 
출하여 그리기사건을 발생시켜 선택창이 있는 구역을 다시 그리고 마우스이동을 고려하여 
rubberBandRect 를 갱신하고 updateRubberBandRegion() 를 두번째로 호출하여 선택창이 이동한 
구역을 다시 그린다 . 이것은 선택창을 효과적으로 지우고 그것을 새로운 자리표에 다시 그린 
다 . 

rubberBandRect 변수는 QRect 형 이 다 . QRect 는 다음과 같이 정 의 할수 있다 . 

(X ，少， tv ， 幻의 4 요소 一 여기서 (자기는 직 4 각형의 왼쪽웃구석의 위치，새는 그 크기 혹은 왼 
쪽웃구석 과 오른쪽아래 구석 자리 표쌍 . 

여기서는 자리표쌍표시를 사용한다 . 사용자가 처음에 찰칵한 점을 왼쪽웃구석으로 설정하 
고 현재 의 마우스위 치 를 오른쪽아래 구석 으로 설 정한다 . 

사용자가 마우스를 우로 혹은 왼쪽으로 옮기면 rubberBandRect 의 명목상 오른쪽아래구석 
이 그 왼쪽웃구석의 우로 혹은 왼쪽으로 된다 . 이려한 일이 생기면 QRect 는 부수폭이나 높이 
를 가전다 . QRect 는 왼쪽웃구석과 오른쪽아래구석의 자리표들을 조절하여 부가 아닌 폭과 높 
이를 얻는 normalizeO 함수를 가지고있다 . 

void Plotter: :mouseReleaseEvent(QMouseEvent *event) 

{ 

if (event->button() == LeftButton) { 
rubberBandlsShown = false; 
updateRubberBandRegion(); 
unsetCursor(); 

QRect rect = rubberBandRect.normalize(); 
if (rect.width() < 4 || rect.height() < 4) 
return; 

rect.moveBy(-Margin, -Margin); 

PlotSettings prevSettings = zoomStack[curZoom]; 

PlotSettings settings; 

double dx = prevSettings.spanX() / (width() -2 * Margin); 
double dy = prevSettings.spanY() / (height() -2 * Margin); 
settings.minX = prevSettings.minX + dx * rect.left(); 
settings.maxX = prevSettings.minX + dx * rect.right(); 
settings.minY = prevSettings.maxY -dy * rect.bottom(); 
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switch (event->key()) { 
case Key Plus: 
zoomIn(); 
break; 

case Key_Minus: 
zoomOut(); 
break; 

case Key Left: 

zoomStack[curZoom].scroll (- 1, 0); 

refreshPixmap(); 

break; 

case Key Right: 

zoomStack[curZoom].scroll (+ 1, 0); 

refreshPixmap(); 

break; 

case Key Down: 

zoomStack[curZoom].scroll(0, -1); 

refreshPixmap(); 

break; 

case Key Up: 

zoomStack[curZoom]. scroll(0, +1); 

refreshPixmap(); 

break; 

default: QWidget: : keyPressEvent(event); 

} 

} 

사용자가 건을 눌러서 Plotter 창문부품이 초점을 가질 때 keyPressEvent() 함수가 호출된다 . 
여기서 이 함수를 재정의하여 6 개건 즉 +, Up, Down, Left, Right 에 응답한다 . 조종되지 않는 
건을 사용자가 누르면 기초클라스실현을 호출한다 . 간단히 Shift, Ctrl, Alt 수식건들을 무시하는 
데 이것들은 QKeyEvent :: stateO 를 통하여 사용할수 있다 . 
void Plotter: : wheelEvent(QWheelEvent *event) 

{ 


int numDegrees = event->delta() / 8; 
int numTicks = numDegrees / 15; 



if (event->orientation() == Horizontal) 

zoomStack[curZoom].scroll(numTicks, 0); 
else 

zoomStack[curZoom] .scroll(0, numTicks); 
refreshPixmap(); 

} 

바퀴사건은 마우스바퀴를 굴릴 때 발생한다 . 대부분의 마우스는 오직 수직바퀴만 제공하 
지만 일부는 수평바퀴를 가지고있다 . 어는 두 종류의 바퀴를 유지한다 . 바퀴사건들은 초점을 
가지는 창문부품으로 간다 . delta() 함수는 바퀴가 회전한 거리를 8 도단위로 돌려준다 . 일반적으 
로 마우스는 15 도걸음으로 작업한다 . 

바퀴마우스의 가장 일반적인 사용은 흘림띠를 이동시키는것이다 . QScrollView(6 장에서 설 
명)의 파생클라스를 만들어 흘림띠들을 제공할 때 QScrollView 는 바퀴마우스사건들을 자동적 
으로 처리하므로 자체로 wheelEvent() 를 재정의하지 않는다 . 또한 QScrollView 를 계승하는 
QListView, QTable, QTextEdit 와 같은 Qt 클라스들은 추가적 인 코드를 요구하지 않고도 바퀴 사건 
들을 유지한다 . 

이 것으로 사건처 리함수들의 실현을 끝낸다 . 이제는 비 공개 함수들을 고찰하자 . 

void Plotter: : updateRubberBandRegion() 

{ 

QRect rect = rubberBandRect.normalize(); 
update(rect.left(), rect.top(), rect.width(), 1); 
update(rect.left(), rect.top(), 1, rect.height()); 
update(rect.left(), rect.bottom(), rect.width(), 1); 
update(rect.right(), rect.top(), 1, rect.height()); 

} 

updateRubberBand() 함수는 mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent() 로부터 
호출되여 선택창을 지우거나 다시 그린다 . 이것은 선택창에 의해 포함되는 작은 4 개의 직 4 각 
형구역들에 대하여 그리기사건을 발생하는 update() 의 4 개의 호출로 이루어진다 . 

NOT 를 리용한 선택창그리기 

선택창을 그리는 일반적 인 방법은 NOT (혹은 XOR) 수학연산자를 사용하는것이다 . 이 연 
산자는 선택창우의 매개 화소값을 반대의 bit 견본으로 교체한다 . 여기에 다음과 같은 일을 
수행하는 updateRubberBandRegion() 의 새로운 판이 있다 . 

void Plotter: : updateRubberBandRegion() 

{ 

QPainter painter(this); 
painter.setRasterOp(NotROP); 
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painter.drawRect(rubberBandRect.nonnalize()); 

} 

setRasterOp() 호출은 painter 의 라스터 조작을 NcrtROP 로 설 정한다 . 원래 판에 서 는 기 정 값 
CopyROP 를 유지하였는데 이것은 QPainter 에게 원시값에 새 값을 단순히 복사한다 . 

updateRubberBandRegionO 를 같은 자리표에 대하여 두번 호출할 때 두개의 NOT 가 서로 
취소되므로 원래 화소들이 되살아난다 . 

NOT 사용의 우점은 실현하기 쉽고 가리워진 구역들의 사본을 보관할 필요가 없다는것 
이다 . 그러나 일반적으로 이것은 적용할수 없다 . 례를 들면 선택창대신에 본문을 그린다면 
본문은 아주 읽 기 힘들다 . 또한 NOT 는 늘 좋은 결과를 생성하지 않는다 . 례를 들면 중간재 
색 은 그대 로 남아있다 . 끝으로 NOT 는 Mac OS 표에 서 유지 하지 않는다 . 

다른 수법은 선택창을 동화상의 접선으로 표시하는것이다 . 이것은 흔히 화상조작프로그 
탐들에서 사용한다 . 그것은 화상에서 어떤 색 이 발견되는가에 관계 없이 좋은 대조를 제공하 
기때문이다 . 이것을 Qt 에서 수행하는 요령은 QObject :: timerEventO 을 재정의하여 선택창을 지 
운 다음 그것을 다시 그리는데 있다 . 
void Plotter: : refreshPixmap() 

{ 

pixmap.resize(size()); 
pixmap.fill(this, 0, 0); 

QPainter painter(&pixmap, this); 
drawGrid(&painter); 
drawCurves(&painter); 
update(); 

} 

refreshPixmapO 함수는 화면밖의 픽스매프를 도면에 다시 그리고 현시를 갱신한다 . 

창문부품과 같은 크기를 가지도록 픽스매프의 크기를 조절하고 그것을 창문부품의 지우 
기색으로 채운다 . 이 색은 Plotter 구성자에서 setBackgroundMode() 를 호출하므로 조색판의 《어 
두운》요소이다 . 

그다음 QPainter 를 창조하여 픽스매프를 그리며 drawGrid() 와 drawCurves() 를 호출하여 그 
리 기한다 . 끝으로 update() 를 호출하여 전 체창문부품용으로 그리 기 사건 을 발생 한다 . 픽 스매 프 
는 paintEvent(*) 함수에서 창문부품에 복사된다 . 
void Plotter: :drawGrid(QPainter *painter) 

{ 

QRect rect(Margin, Margin, width() -2 * Margin, height() -2 * Margin); 

PlotSettings settings = zoomStack[curZoom]; 

QPen quiteDark = colorGroup().dark().light(); 
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QPen light = colorGroup().light(); 

for (int i = 0; i <= settings.numXTicks; ++i) { 

int x = rect.left() + (i * (rect.width() -1) / settings.numXTicks); 

double label = settings.minX + (i * settings.spanX() / settings.numXTicks); 

painter->setPen(quiteDark); 

painter->drawLine(x, rect.top(), x, rect.bottom()); 

painter->setPen(light); 

painter->drawLine(x, rect.bottom(), x, rect.bottom() + 5); 
painter->drawText(x -50, rect.bottom() + 5, 100 ， 15, AlignHCenter | AlignTop, 

QString: : number(label)); 

} 

for (int j = 0; j <= settings.numYTicks; ++j) { 

int y = rect.bottom() -(j * (rect.height() -1) / settings.numYTicks); 

double label = settings.minY + (j * settings.spanY() / settings .numYTicks); 

painter->setPen(quiteDark); 

painter->drawLine(rect.left(), y, rect.right(), y); 

painter->setPen(light); 

painter->drawLine(rect.left() -5, y, rect.left(), y); 

painter->drawText(rect.left() -Margin, y -10, Margin -5, 20, AlignRight | AlignVCenter, 
QString: : number(label)); 

} 

painter->drawRect(rect); 

} 

drawGridO 함수는 곡선과 축들의 배경에 살창을 그린다 . 

처음의 for 순환은 살창의 수직선들과 : c 축의 눈금들을 그린다 . 둘째 for 순환은 살창의 수평 
선들과 :^ 축의 눈금들을 그린다 . drawTextO 함수는 두 축에서 눈금표식에 대응하는 수값들을 그 
린다 . 

drawText() 호출은 다음의 문법을 가전다 . 

painter.drawText(x, 少， w 9 h, alignment, text); 

여기서 (x:, j, w ， 가)는 직 4 각형 을 정의하고 alignment^： 그 직 4 각형 안에서 본문의 위치，仏打는 
그리려는 본문이다 . 

void Plotter: : drawCurves(QPainter *painter) 

{ 

static const QColor colorForIds[6] = { red, green, blue, cyan, magenta, yellow}; 
PlotSettings settings = zoomStack[curZoom]; 
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QRect rect(Margin, Margin, width() -2 * Margin, height() -2 * Margin); 
painter->setClipRect(rect.x() + 1, rect.y() + 1, rect.width() -2, rect.height() -2); 
map<int, CurveData 〉 ::const_iterator it = curveMap.begin(); 
while (it != curveMap.end()) { 
int id = (*it).first; 

const CurveData &data = (*it).second; 

int numPoints = 0; 

int maxPoints;. ■ 니 data.size() / 2; 

QPointArray points(maxPoints); 
for (int i = 0; i < maxPoints; ++i) { 
double dx = data[2 * i] -settings.minX; 
double dy = data[2 * i + 1] -settings.minY; 
double x = rect.left() + (dx * (rect.width() -1) / settings. spanX()); 
double y = rect.bottom() -(dy * (rect.height() -1) / settings.spanY()); 
if (fabs(x) < 32768 && fabs(y) < 32768) { 
points[numPoints] = QPoint((int)x, (int)y); 

++numPoints; 

} 

} 

points .truncate(numPoints); 
painter->setPen(colorForIds[(uint)id % 6]); 
painter->drawPolyline(points); 

++it; 

} 

} 

drawCurves() 함수는 살창우에 곡선들을 그린다 . setClipRect() 호출로 시작하여 QPainter 의 잘 
라내기령역을 곡선을 포함하는 직 4 각형(여 백은 제외)으로 설정한다 . 그때 QPainter 는 구역밖에 
서 화소들에 대 한 그리 기 조작을 무시한다 . 

다음에 곡선들을 모두 순환하면서 매개 곡선에 대하여 그것을 구성하는 ( 切 ；) 자리표쌍들을 
순환한다 . 반복자값의 첫 성원은 곡선의 ID 를 제공하고 둘째 성원은 곡선자료를 제공한다 . 

for 순환의 안쪽부분은 자리표쌍을 Plotter 자리표로부터 창문부품자리표로 변환하여 합리적 
인 경 계 안에 놓여 있는 points 변수에 보관한다 . 사용자가 많이 확대 하면 16bit signed 옹근수로 표 
시할수 없는 수들로 되며 이것은 창문체계에 따라서 부정확한 표시를 발생시킨다 . 

곡선의 모든 점들을 창문부품자리표로 변환하였다면 곡선의 펜색을 미리 정의된 색들중 
하나로 설정하고 drawPolyline() 를 호출하여 곡선의 모든 점들을 지나는 선을 그린다 . 
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이것은 완성된 Plotter 클라스이다 . 남은것은 PlotSettings 의 일부 함수들이다 . 

PlotSettings: :PlotSettings() 

{ 

minX = 0.0; 
maxX = 10.0; 
numXTicks = 5; 
minY = 0.0; 
maxY= 10.0; 
numYTicks = 5; 

} 

PlotSettings 구성자는 두개의 축을 범위가 0 〜 10 이고 5 단위의 눈금표식을 가지도록 초기화 
한다 . 

void PlotS ettings :: scroll(int dx, int dy) 

{ 

double stepX = spanX() / numXTicks; 

minX += dx * stepX; 

maxX += dx * stepX; 

double stepY = spanY() / numYTicks; 

minY += dy * stepY; 

maxY += dy * stepY; 

} 

scrollO 함수는 두 눈금사이의 간격 에 주어진 수를 급하여 minX, maxX, minY, maxY 를 증가 
혹은 감소시킨다 . 이 함수는 Plotter::keyPressEvent(} 에서 흘림을 실현하는데 쓰인다 . 
void PlotSettings::adjust() 

{ 

adjustAxis(minX, maxX, numTicks); 
adjustAxis(minY, maxY, numYTicks); 

} 

adjust() 함수는 mouseReleaseEvent() 로부터 호출되 여 minX, maxX, minY, maxY 값들을《좋은》 
값들로 둥그리 기 하고 매 개 축에 적 당한 눈금수를 결 정한다 . 비 공개 함수 adjustAxis() 는 한번 에 
한개 축에 대하여 이 작업을 수행한다 . 

void PlotSettings: : adjustAxis(double &min, double &max, int &numTicks) 

{ 

const int MinTicks = 4; 

double grossStep = (max -min) / MinTicks; 


138 



double step = pow(10, floor(log 10(grossStep))); 
if (5 * step < grossStep) 
step *= 5; 

else if (2 * step < grossStep) 
step *= 2; 

numTicks = (int) (ceil(max / step) -floor(min / step)); 
min = floor(min / step) * step; 
max = ceil(max / step) * step; 

} 

adjustAxis () 함수는 min 과 max 파라메 터들을 《좋은》수들로 변환하고 numTicks 파라메 터를 
주어 진 [min,max ] 범 위 에 알맞도록 계 산한 눈금수로 설 정 한다 . adjustAxisO 가 사본이 아니 라 실 
제 변 수들 (minX, maxX, numXTicks 등)을 수정 해 야 하므로 그 파라메 터 들은 비 const 참고이 다 . 

adjustAxisO 의 대부분의 코드는 단순히 2 눈금 ( 걸음)사이의 간격에 알맞는 값을 결정하려고 
한다 . 축을 따라 좋은 수들을 얻기 위해서는 세밀하게 걸음을 선택해야 한다 . 례를 들면 걸음 
값 3.8 은 축을 3.8 의 배로 되게 한다 . 10 진수로 표식된 축들에서 좋은 걸음값들은 10 n ,2-10 n , 혹 
은 5.10 n 형식의 수이다 . 

걸음값에 대하여 최대값인 《총걸음》을 계산하는것으로 시작한다 . 그다음 총걸음과 같거 
나 작은 10 n 형식의 대응하는 수를 찾는다 . 총걸음의 상용로그를 취하고 그 값을 그 수아래로 
둥그리 기한 수로 10 을 제급하여 이 것을 수행 한다 . 례를 들면 총걸음이 236 이 면 log 236 = 
2.37291 ...을 계산하고 그것을 둥그리여 2 를 엄고 10 n 형식의 후보걸음값으로서 10 2 = 100 을 얻는 
다 . 

첫 후보걸음값이 있으면 그것을 리용하여 다른 2 개 후보 2.10 n 과 5.10 n 을 엄는다 . 우의 실 
례 에서 2 개의 다른 후보는 200 과 500 이 다 . 500 은 총걸음보다 크므로 리 용할수 없다 . 그러 나 
200 은 236 보다 작으므로 이 실례에서는 걸음크기로 200 을 사용한다 . 

걸음값으로부터 numTicks, min, max 를 끌어 내기 는 아주 쉽 다 . 새로운 min 값은 원래의 min 
을 걸음의 가장 가까운 배수쪽으로 아래로 둥그리기하여 엄으며 새로운 max 값은 걸음의 가 
장 가까운 배 수쪽으로 올리 둥그리 기 하여 얻 는다 . 새 로운 numTicks 는 둥그리 기 한 min 과 max 값 
사이의 수이다 . 례를 들면 min 이 240 이고 max 가 1184 이면 새 범위는 [200, 120 이 , 걸음표식은 
5 로 된다 . 

이 알고리듬은 일부 경우에 부분최 량결과를 준다 . 

이 장에서는 현존 Qt 창문부품을 사용자정의하는 방법과 QWidget 를 기초클라스로 사용하여 
창문부품을 철저히 건설하는 방법을 설명하였다 . 이미 2 장에서 현존창문부품들로부터 창문부 
품을 구성 하는 방법 을 보았으며 6 장에서 주제 화상 (theme ) 을 더 설명한다 . 

이 시점에서 우리는 Qt 를 리용하여 GUI 응용프로그람들을 쓰는 방법을 충분히 알고있다 . 
다음 장들부터는 Qt 를 더 깊이 설명하여 여의 능력을 완전히 사용할수 있게 한다 . 
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제 6 장. 배치관리 


폼에 배치되는 매개 창문부품에는 적당한 크기와 위치가 주어져야 한다 . 일부 큰 창문부 
품들은 사용자가 그 내용을 모두 호출하는데 홀림띠를 요구한다 . 이 장에서는 폼에서 창문부 
품들의 각이한 배 치방법 을 고찰하며 류동가능창문과 MDI 창문을 실 현하는 방법 을 설 명한다 . 

제1절. 기본배치 

Qt 는 폼에 있는 자식창문부품들의 배치를 관리하는 3 가지 기본방법 즉 절대위치지정，수 
동배치 및 배치관리자를 제공한다 . 그림 6-1 에 실례로서 보여주는 Find File 대화칸을 리용하여 
이 수법들을 차례로 고찰한다 . 



그림 6-1. Find File 대 화칸 

절대위치지정은 창문부품들을 배치하는 가장 원시적인 방법이다 . 절대위치지정은 폼의 자 
식창문부품들에 고정크기와 위 치를 할당하고 폼에 고정크기를 할당하여 실현한다 . 여기 에는 
FindFileDialog 구성자에서 절대위치지정을 사용하는 방법을 보여준다 . 

FindFileDialog :: FindFileDialog(QWidget ^parent, const char *name) : QDialog(parent, name) 

{ 

namedLable->setGeometry(10, 10, 50, 20); 
namedLineEdit->setGeometry(70, 10, 200, 20); 
lookInLabel->setGeometry( 10, 35, 50, 20); 
lookInLineEdit->setGeometry(70, 35, 200, 20); 


subfoldersCheckBox->setGeometry(10, 60, 260, 20); 
listView->setGeometry(10, 85, 260, 100); 
messageLabel->setGeometry(10, 190, 260, 20); 
findButton->setGeometry(275, 10, 80, 25); 
stopButton->setGeometry(275, 40, 80, 25); 
closeButton->setGeometry(275, 70, 80, 25); 
helpButton->setGeometry(275, 185, 80, 25); 
setFixedSize(365, 220); 

} 

절대위치지정에는 많은 결함이 있다 . 첫째 문제는 사용자가 창문크기를 조절할수 없는것 
이다 . 또 하나의 문제는 사용자가 큰 서체를 선택하거나 혹은 응용프로그람이 다른 언어로 
번역되면 일부 본문이 잘리우는것이다 . 그리고 이 수법은 또한 지루하게 위치와 크기를 계산 
하여야 한다 . 

절대위치를 지정하는 다른 수법은 수동배치이다 . 수동배치 (manual layout) 에서는 창문부품 
들이 여전히 절대위치로 주어지지만 그 크기는 완전히 고정되지 않고 창문크기에 비례하여 
정 해진다 . 이것은 폼의 resizeEventO 함수를 재정의하여 자식 창문부품의 기하학적 형태를 설정하 
는 방법 으로 달성한다 . 

FindFileDialog :: FindFileDialog(QWidget ^parent, const char *name) : QDialog(parent, name) 


setMinimumSize(215, 170); 
resize(365, 220); 

} 

void FindFileDialog :: resizeEvent(QResizeEvent *) 

{ 

int extra Width = width() -minimumWidth(); 
int extraHeight = height() -minimumHeight(); 
namedLabel->setGeometry( 10, 10, 50, 20); 
namedLineEdit->setGeometry(70, 10, 50 + extraWidth, 20); 
lookInLabel->setGeometry( 10, 35, 50, 20); 
lookInLineEdit->setGeometry(70, 35, 50 + extraWidth, 20); 
subfoldersCheckBox->setGeometry(10, 60, 110 + extraWidth, 20); 
listView->setGeometry( 10, 85, 110 + extraWidth, 50 + extraHeight); 
messageLabel->setGeometry( 10, 140 + extraHeight, 110 + extraWidth, 20); 
findButton->setGeometry( 125 + extraWidth, 10, 80, 25); 
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그림 6-2. 크기 조절 가능대 화칸의 크기변경 

폼우의 창문부품들을 배치하는 가장 좋은 해결책은 여의 배치관리자를 사용하는것이다 . 배 
치관리자는 매개 형의 창문부품에 의식할수 있는 기정값들을 제공하며 창문부품의 서체 , 형식 , 
내용에 의존하는 매개 창문부품의 크기암시를 고려한다 . 또한 배치관리자는 최소크기와 최대크 
기를 고려하고 서체변경，본문변경 , 창문크기변경에 대하여 자동적으로 배치를 조절한다 . 

(가는 3 가지 배치관리자 즉 QHBoxLayout, QVBoxLayout, QGridLayout 를 제공한다 . 이 클라 
스들은 QLayout 를 계 승한다 . QLayout 는 배 치 의 기 본틀거 리 를 제 공한다 . 3 개 의 클라스들은 모두 
Qt Designer 에 의해 완전히 유지 되 여있고 코드에서 도 사용할수 있다 . 2 장에서 두 수법 의 실 례 
들을 제시하였다 . 

여기에 배치관리자들을 사용하는 FindFileDialog 코드가 있다 . 

FindFileDialog: : FindFileDialog(QWidget ^parent, const char *name) : QDialog(parent, name) 

{ 


i ■.■베바^ ■•- 


closeButton->setGeometry( 125 + extrawidth, 70, 80, 25); 
helpButton->setGeometry( 125 + extra Width, 135 + extraHeight, 80, 25); 

유 

FindFileDialog 구성자에서는 폼의 최소크기를 215x170 으로 설정하고 그 
220 으로 설 정 한다 . resizeEvent () 함수에 서 는 늘이 려 는 창문부품들에 여 유공간사 
절대위치지정처럼 수동배치 는 프로그람작성 자가 계산해 야 할 고정정 수들을 
기 려한 코드를 쓰면 설계 가 달라지 는 경 우에 아주 시 끄럽 다 . 그리 고 여 전히 
며 험 이 있다 . 그러한 위 험은 자식창문부품들의 크기암시를 고려하여 피할수 
L 드를 더 복잡하게 만든다 . 
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QGridLayout *leftLayout = new QGridLayout; 
leflLayout->addWidget(namedLabel ? 0 ， 0); 
leftLayout->addWidget(namedLineEdit, 0 ， 1); 
leflLayout->addWidget(lookInLabel, 1, 0); 
leftLayout->addWidget(lookInLineEdit, 1, 1); 
leflLayout->addMultiCellWidget(subfoldersCheckBox, 2, 2, 0, 1); 
leftLayout->addMultiCellWidget(listView, 3, 3, 0, 1); 
leflLayout->addMultiCellWidget(messageLabel, 4, 4, 0, 1); 
QVBoxLayout *rightLayout = new QVBoxLayout; 
rightLayout->addWidget(findButton); 
rightLayout->addWidget(stopButton); 
rightLayout->addWidget(closeButton); 
rightLayout->addStretch( 1); 
rightLayout->addWidget(helpButton); 

QHBoxLayout *mainLayout = new QHBoxLayout(this); 


mainLayout->setMargin( 11); 
mainLayout->setSpacing(6); 
mainLayout->addLayout(leflLayout); 
mainLayout->addLayout(rightLayout); 


배 치 는 QHBoxLayout, QGridLayout, QVBoxLayout 에 의 하여 조종된다 . QGridLayout 는 왼쪽에， 
QVBoxLayout 는 오른쪽에 나란히 배치되고 QHBoxLayout 는 바깥쪽에 배치된다 . 대화칸주위의 
여 백은 11 화소이고 자식창문부품들사이 의 공백은 6 화소이 다 . 



그림 6-3. Find File 대 화칸의 배 치 


143 















QGridLayout 는 2 차원살창의 세 포들에 대 하여 작업한다 . 배 치 관리 자의 왼쪽웃구석 에 있는 
QLabel 은 위치 (0, 0) 에： 대응하는 QLineEdit 는 위치 (0, 1 ) 에 있다 . QCheckBox 는 두 칸에 전개 
되여 위치 (2, 0 ) 과 (2, 1 ) 의 세포들을 차지한다 . 그아래에 QListView 와 QLabel 도 두 칸에 전개 
된다 .addMultiCellWidget () 호출은 다음의 문법을 가전다 . 

leftLayout->addMultiCellWidget(w/c/ge/, rowl, row2, coll, col2); 

여 기서 widget 는 배치 관리자에 삽입하려 는 자식 창문부품， (raw7, co/7 ) 은 창문부품이 차지 한 
왼 쪽웃구석 세 포， ( TOW 2, CO /2 ) 는 창문부품이 차지 한 오른쪽 아래 구석 세 포이 다 . 

Qt Designer 에서 자식 창문부품들을 적 당한 위치 에 배치하고 배치 할것들을 선택한 다음 La 
yout|Lay Out Horizontally, Layout|Lay Out Vertically, 혹은 Layout|Lay Out in a Grid 를 찰칵하여 
대화칸을 시각적으로 창조할수 있다 . 이 수법은 2 장에서 표계산프로그람의 Go-to-Cell 과 Sort 
대화칸들을 창조하는데 사용되였다 . 

배치관리자의 사용은 우리가 지금까지 론의한것외에 다른 좋은 점도 있다 . 배치관리자에 
창문부품을 추가하거나 배치관리자에서 창문부품을 삭제할 때 배치관리자는 자동적으로 새로 
운 상황에 적 응된다 . 또한 자식창문부품에 대 하여 hide () 나 show () 를 호출하여 적 용할수도 있 
다 . 자식창문부품의 크기암시 가 달라지면 배 치관리 자들은 자동적 으로 새 크기암시 를 고려 하 
여 재시행된다 . 또한 배치관리자들은 폼의 자식창문부품들의 최소크기와 크기암시들에 기초 
하여 폼전 체 의 최 소크기 를 자동적 으로 설 정한다 . 

지금까지 제시한 매개의 실례에서는 배치관리자에 단순히 창문부품들을 넣고 수축자가 나머 
지 공간을 차지하도록 하였다 . 흔히 우리가 바라는것과 꼭같이 배치할수는 없다 . 그러한 상황에서 
는 배치하고있는 창문부품들의 크기방략과 크기암시들을 변경하여 배치를 조절할수 있다 . 

창문부품의 크기방략 (size policy ) 은 배 치 체계 에 창문부품을 늘이거 나 줄이 는 방법 을 말해 
준다 . 어는 자기 의 모든 기 본창문부품들에 대 하여 기 정 크기암시값들을 제 공한다 . 그러 나 가능 
한 매개 배 치 관리 자에 대 하여 하나의 기 정 값만 고려할수 없으므로 폼우의 하나이 상의 창문부 
품들에 대하여 크기방략들을 변경 하는것은 개발자들에게 있어서 아직 관례로 되 여있다 . 크기 
암시는 수평 및 수직요소들을 모두 가진다 . 매개 요소에 대한 가장 유효한 값들은 Fixed, 
Minimum, Maximum, Preferred, Expanding 이 다 . 

• Fixed 는 창문부품을 늘이거 나 줄일수 없다는것을 의 미한다 . 창문부품은 늘 그 크기암시 
의 크기로 된다 . 

• Minimum 은 창문부품의 크기 암시 가 최 소크기 라는것 을 의 미 한다 . 창문부품은 크기 암시 아 
래로 줄일수 없지만 필요하다면 유효공간을 다 채우도록 늘일수 있다 . 

• Maximum 은 창문부품의 크기 암시 가 최 대 크기 라는것 을 의 미 한다 . 창문부품은 그 최 소크 
기암시까지 줄일수 있다 . 

- Preferred 는 창문부품의 크기 암시 가 적 당한 크기 라는것 을 의 미 하지 만 필 요하다면 창문부 
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품을 늘이거나 줄일수 있다 . 

•Expanding 은 창문부품을 늘이거나 줄일수 있는데 특히 늘일수 있다는것을 의미한다 . 

그림 6-4 은 본문 "Some Text" 를 표시하는 QLabel 을 례들어 각이한 크기 방략의 의 미를 요 
약하여 보여준다 . 


minsixt hint sizthinl 

_—_ _- 


Fixed 

| Some Text | 


Ninittun 

| Some Text | 

—► | Some Text 

Maxinua 

[ Sorj • » | Somd Text j 


Preferred 

|Sorj ， - ► |Son 的 Te 비 •一 

—► | Some Text 

Expandin9 

|Sorj < » | Some Text | ♦一 

—► | Some Text 


그림 6-4. 각이한 크기방략들의 의 미 

Preferred 창문부품과 Expanding 창문부품들을 모두 포함하는 폼의 크기를 조절할 때 
Expanding 창문부품들에 여 유공간이 주어 지 고 Preferred 창문부품들은 자기 의 크기 암시 의 크기 를 
그대 로 유지한다 . 

두가지 다른 크기방략 즉 MinimumExpanding 과 Ignored 가 있다 . MinimumExpanding 은 낡은 
판의 Qt 에서 아주 적은 경우에 필요하였지만 더는 사용하지 않으며 더 좋은 수법은 
Expanding 을 사용하여 minimumSizeHintO 을 적당히 재정의하는것이다 . Ignored 는 Expanding 과 
비 슷한데 창문부품의 크기암시 를 무시 한다는것 이 다트다 . 

크기 암시 의 수평 및 수직 요소들외 에 QSizePolicy 클라스는 수평 및 수직 늘임 곁 수 (stretch 
factor) 를 둘다 보유한다 . 이 늘임 곁 수들은 폼을 확장할 때 각이 한 자식창문부품들을 각이한 
비률로 늘여 야 한다는것 을 지 적 하는데 쓰인 다 . 례 를 들면 QTextEdit 우에 QListView 가 있고 
QTextEdit 를 QListView 의 두배 로 늘이 려 고 한다면 QTextEdit 의 수직늘임 곁 수를 2 로， QListYiew 
의 수직 늘임 곁 수를 1 로 설정한다 . 

배치 에 영 향을 주는 다른 수법 은 자식창문부품들에 대하여 최 소크기，최 대크기 또는 고정 
크기 를 설정 하는것 이 다 . 배 치 관리자는 창문부품들을 배치할 때 이 제 한들을 고려한다 . 그리 고 
이것 이 충분하지 않으면 늘 자식창문부품의 클라스로부터 파생하고 sizeHintO 를 재정의하여 
필 요한 크기암시 를 얻 는다 . 


제2절. 분할기 

분할기 (splitter) 는 다른 창문부품들을 포함하는 창문부품으로서 창문부품들을 분할기손잡 
이 (handle) 들에 의 하여 분리 한다 . 사용자들은 손잡이 를 끌기 하여 분할기 의 자식 창문부품들의 
크기 를 변 경할수 있다 . 흔히 분할기 들은 사용자에 게 조종권 을 더 주기 위한 배 치 관리 자들의 
또 하나의 수법으로 사용된다 . 
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그림 6-5. Splitter 응용프로그람의 창문부품들 


어는 QSplitter 창문부품에 의 해 분할기 들을 유지 한다 . QSplitter 의 자식 창문부품들은 그것 이 
창조되는 순서로 자동적으로 나란히(혹은 우아래로 ) 배치되고 이웃창문부품들사이에는 분할띠 
(splitterbar) 들이 있다 . 여기에 그림 6-5 에 보여주는 창문을 창조하는 코드가 있다 . 

#include <qapplication.h> 

#include <qsplitter.h> 

#include <qtextedit.h> 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

QSplitter splitter(Qt: : Horizontal); 
splitter.setCaption(QObject::tr( M Splitter")); 
app. setMainWidget(&splitter); 

QTextEdit *firstEditor = new QTextEdit(&splitter); 

QTextEdit *secondEditor = new QTextEdit(&splitter); 

QTextEdit *thirdEditor = new QTextEdit(&splitter); 

splitter.show(); 

return app.exec(); 

} 

실례는 QSplitter 창문부품에 의해 수평배치된 3 개의 QTextEdit 들로 이 루어 진다 . 폼의 자식 
창문부품들을 배치만 하는 배치관리자와는 달리 QSplitter 는 QWidget 를 계승하고 다른 창문부 
품처럼 사용할수 있다 . 

QSplitter 는 자식창문부품들을 수평 혹은 수직 으로 배 치한다 . 복합배 치 는 수평 및 수직 
QSplitter 들을 겹쌓아서 엄을수 있다 . 례를 들면 그림 6-6 에 보여주는 Mail Client 응용프로그람 
은 오른변에 수직 QSplitter 를 포함하는 수평 QSplitter 로 이루어진다 . 
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그림 6-6. Mac OS 표에 서 Mail Client 응용프로그람 
여기 에 Mail Client 응용프로그람에 서 QMainWindow 파생클라스구성 자의 코드가 있다 . 
MailClient: : MailClient(QWidget ^parent, const char *name) : QMainWindow(parent, name) 
{ 

horizontalSplitter = new QSplitter(Horizontal, this); 

setCentralWidget(horizontalSplitter); 

foldersListView = new QListView(horizontalSplitter); 

foldersListView->addColumn(tr( n Folders M )); 

foldersListView->setResizeMode(QListView::AllColumns); 

verticalSplitter = new QSplitter(Vertical, horizontalSplitter); 

messagesListView = new QListView(verticalSplitter); 

messagesListView->addColumn(tr( n Subject n )); 

messagesListView->addColumn(tr("Sender")); 

messagesListView- 〉 addColumn ( 仕 ("Date")); 

messagesListView->setAllColumnsShowFocus(true); 

messagesListView->setShowSortIndicator(true); 

messagesListView->setResizeMode(QListView::AllColumns); 

textEdit = new QTextEdit(verticalSplitter); 

textEdit->setReadOnly(true); 






















horizontalSplitter->setResizeMode(foldersListView, QSplitter: : KeepSize); 
verticalSplitter->setResizeMode(messagesListView, QSplitter: : KeepSize); 

readSettings(); 

} 

우선 수평 QSplitter 를 창조하고 그것 을 QMainWindow 의 중심 창문부품으로 설 정 한다 . 그다 
음 자식창문부품들과 그것 들의 자식창문부품들을 창조한다 . 

사용자가 창문크기 를 변경할 때 QSplitter 는 보통 공간을 분배하여 관련된 자식창문부품들 
의 크기가 같아지게 한다 . Mail Client 실례 에서는 이 러한 동작을 요구하지 않고 그대신 자식 창 
문부품들의 크기를 2 개의 QListView 가 관리 할것을 요구하며 QTextEdit 에 여유공간을 주려고 
한다 . 이 것은 거의 마감에 2 번의 setResizeMode() 호출에 의해 달성 된다 . 

응용프로그람이 기 동할 때 QSplitter 는 자식창문부품들에 게 그것 들의 초기 크기 에 기 초하여 
적당한 크기를 준다 . QSplitter::setSizes() 를 호출하여 분할기손잡이를 프로그람적으로 이동할수 
있다 . 또한 QSplitter 클라스는 자기의 상태를 보관하고 응용프로그람이 다음번에 실행될 때 상 
태를 되살리는 수단을 제공한다 . 여기에 Mail Client 의 설정을 보관하는 writeSettings() 함수가 
있다 . 

void MailClient: : writeSettings() 

{ 

QSettings settings; 

settings.setPath("software-inc.com", n MailClient n );settings.beginGroup( n /MailClient M ); 

QString str; 

QTextOStream outl(&str); 

outl » *horizontalSplitter; 

settings.writeEntry( n /horizontalSplitter", str); 

QTextOStream out2(&str); 
out2 » *verticalSplitter; 
settings.writeEntry("/verticalSplitter", str); 
settings. endGroup(); 

} 

여기에 대응하는 readSettings() 함수가 있다 . 

void MailClient: : readSettings() 

{ 

QSettings settings; 

settings.setPath( n software-inc.com n , ’’MailClient");settings.beginGroup("/MailClient’’); 

QString strl = settings.readEntry("/horizontalSplitter M ); 
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QTextIStream inl(&strl); 
ini » ’horizontalSplitter; 

QString str2 = settings.readEntryCVverticalSplitter"); 

QTextIStream in2(&str2); 
in2 » *verticalSplitter; 
settings. endGroup(); 

} 

이 함수들은 QTextIStream 과 QTextOS 仕 earn, 2 개의 QTextStream 편의 파생 클라스들에 기초하 
고있 다 . 

기정으로 분할기손잡이는 사용자가 그것을 끌고다닐 때 선택창으로 표시되고 분할기손잡 
이의 어느 한쪽에 있는 창문부품의 크기는 사용자가 마우스단추를 놓을 때만 조절된다 . 실제 
로 QSplitter 가 자식 창문부품들의 크기 를 변경 하기 위 해서 는 setOpaqueResize(true ) 를 호출하군 
한다 . 

QSplitter 는 Qt Designer 에 의하여 완전히 유지된다 . 창문부품들을 분할기에 넣기 위해서는 
요구되는 위치 에 자식창문부품들을 대 략적으로 배치하고 그것들을 선택한 다음 Layout|Lay 
Out Horizontally(in Splitter) 혹은 Layout|Lay Out Vertically(in Splitter ) 를 찰칵한다 . 

제 3 절. 창문부품탄창 

배치를 관리하는 다른 하나의 창문부품은 QWidgetStack 이다 . 이 창문부품은 일련의 자식 
창문부품들이나《폐 지》들을 포함하며 한번 에 하나만 사용자에게 표시 하고 다른 것 은 숨긴다 . 
폐지 에는 0 으로 시작하는 번호가 지 정된다 . 특정한 자식창문부품을 볼수 있게 하려면 폐지번 
호나 자식창문부품의 지 적 자를 가지 고 raiseWidget () 를 호출한다 . 

QWidgetStack 자체는 보이 지 않고 사용자가 폐지 를 변경 하기 위 한 뚜렷 한 시 각적 요소도 
제공되는것이 없다 . 그림 6-7 의 작은 화살표들과 검은 회색틀은 QWidgetStack 를 쉽게 설계하 
도록 하기 위하여 Qt Designer 에서 제공한다 . 


里 wner: | Administrator ᅬ 
[7 Read-only 
厂 Hidden 


그림 6-7. QWidgetStack 

그림 6-8 에 보여주는 Configure 대화칸은 QWidgetStack 를 사용하는 실례이다 . 대화칸의 왼 
쪽에는 QListBox, 오른쪽에는 QWidgetStack 가 있다 . QListBox 의 매개 항목은 QWidgetStack 안의 
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각이 한 폐지 에 대응된다. 이 와 같은 폼은 에서 생성 하기 쉽 다. 

① Dialog 혹은 Widget 형 판에 기초하는 새로운 폼을 창조한다. 

② 폼에 목록칸과 창문부품탄창을 각각 하나씩 추가한다. 

③ 각 창문부품탄창폐지 를 자식창문부품들과 배치 관리 자들로 채운다. (새 폐지 를 창조하 
려 면 오른쪽단추를 찰칵하고 Add Page 를 선 택 한다. 폐 지 들을 절환하려 면 창문부품탄창의 오른 
쪽 웃끝에 배치된 아주 작은 왼쪽화살표 혹은 오른쪽화살표를 찰칵한다.) 

④ 창문부품들을 수평 배 치한다. 

⑤ 목록칸의 highlighted(int) 신호를 창문부품탄창의 raiseWidget(int) 처 리 부에 련결 한다. 

⑥ 목록칸의 currentltem 속성 값을 0으로 설정 한다. 
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그림 6-8. Configure 대 화칸 


미 리 정의 된 신호와 처 리 부에 의하여 폐지절환을 실현하였으므로 대화칸은 Qt Designer 에 
서 미 리 보기했을 때 정 확한 폐 지절환동작을 보여 준다. 

제4절. 흘림보기 

QScrollView 클라스는 흘림 가능한 보기 구역，2개 의 홀림 띠，하나의《구석》창문부품(보통 빈 
QWidget) 을 제공한다. 창문부품에 홀림띠들을 추가하려면 자체로 QScrolfflar 들의 실례를 만들 
고 흘림기능을 실현하기보다 QScrollView 를 사용하는것이 훨씬 더 간단하다. 

QScrollView 를 사용하는 가장 간단한 방법은 흘림띠를 추가하려는 창문부품에 대하여 
addChildO 를 호출하는것이다. QScrollView 은 자동적으로 창문부품을 보기 구역 (QScrollView: : 
viewport() 를 통하여 호출할수 있다)의 자식으로(이미 자식으로 설정되지 않는 경우에만) 설정 
한다. 실례로 5장에서 개발한 IconEditor 창문부품주위에 흘림띠들이 필요하다면 다음과 같이 
쓸수 있다. 
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그림 6-9. QScrollView 의 구성 창문부품들 
#include < qapplication . h > 

#include < qscrollview . h > 

#include " iconeditor . h " 

int main(int argc , char * argv []) 

{ 

QApplication app ( argc , argv ); 

QScrollView scrollView ; 

scrollView . setCaption ( QObject : : tr("Icon Editor ’’)); 
app . setMainWidget (& scrollView ); 

IconEditor *iconEditor = new IconEditor ; 
scrollView . addChild ( iconEditor ); 
scrollView . show (); 
return app . exec (); 

} 

기정으로 흘림띠들은 보기구역이 자식창문부품보다 작을 때에만 표시된다. 다음과 같이 
코드를 써서 홀림띠들이 늘 표시되게 할수 있다. 

scrollView . setHScrollBarMode ( QScrollView :: AlwaysOn ); 
scrollView . setV S crollBarMode(Q Scroll Vie w :: AlwaysOn ); 

자식창문부품의 크기암시 가 달라질 때 QScrollView 는 자동적 으로 새 로운 크기암시 를 받아 
들 인다. 






창문부품을 가지는 QScrollView 를 사용하는 다른 방법은 창문부품이 QScrollView 를 계 
II 하고 내용을 그리는 drawContentsO 를 재정의하는것이다 . 이것은 QlconView, QListBo 
stView, QTable, (^TextEdit 와 같은 Qt 클라스들에서 사용한 수법 이다 . 일반적으로 창문부품 1 
!띠들을 요구한다면 QScrollView 의 파생클라스를 실현하는것이 좋은 생각이다 . 

그 작업방법을 보여주기 위하여 새로운 판의 IconEditor 클라스를 QScrollView 파생클라스 . 
실현한다 . 새 클라스를 ImageEditor 라고 부르고 그 흘림띠들이 큰 화상을 조종할수 있 : 
는다 . 

#ifndef IMAGEEDITOR_H 
#define IMAGEEDITOR_H 
#include <qimage.h> 

#include <qscrollview.h> 
class ImageEditor : public QScrollView 
{ 

Q_OBJECT 

Q_PROPERTY(QColor penColor READ penColor WRITE setPenColor) 

Q PROPERTY(Qlmage image READ image WRITE setlmage) 

Q_PROPERTY(int zoomFactor READ zoomFactor WRITE setZoomFactor) 
public: 

ImageEditor(QWidget *parent = 0, const char *name = 0); 
void setPenColor(const QColor &newColor); 























void setZoomFactor(int newZoom); 
int zoomFactor() const { return zoom;} 
void setImage(const Qlmage &newlmage); 
const Qlmage &image() const { return curlmage;} 
protected: 

void contentsMousePressEvent(QMouseEvent *event); 
void contentsMouseMoveEvent(QMouseEvent *event); 
void drawContents(QPainter *painter, int x, int y, int width, int height); 
private: 

void drawImagePixel(QPainter *painter, int i, int j); 
void setImagePixel(const QPoint &pos, bool opaque); 
void resizeContents(); 

QColor curColor; 

Qlmage curlmage; 
int zoom; 

}； 

#endif 

머 리부파일은 원래 클라스와 거의 비슷하다 . 주요한 차이는 QWidget 대신에 QScrollView 로 
부터 계승하는것이다 . 클라스의 실현을 고찰할 때 다른 차이도 고찰한다 . 
ImageEditor::ImageEditor(QWidget ^parent, const char *name) 

: QScrollView(parent, name, WStaticContents | WNoAutoErase) 

{ 

curColor = black; 
zoom = 8; 

curlmage.create( 16, 16, 32); 
curImage.fill(qRgba(0, 0, 0, 0)); 
curlmage.setAlphaBuffer(true); 
resizeContents(); 

} 

구성자는 WStaticContents 와 WNoAutoErase 기발들을 QScrollView 에 넘긴 다 . 이 기발들은 실 
제로 보기 구역 에 설정된다 . QScrollView 의 기 정 값 (Expanding,Expanding) 이 적 당하므로 크기 암시 
를 설정하지 않는다 . 

원래 판에서는 어의 배치관리자들에 의하여 자체로 초기의 창문부품크기를 선택할수 있 
으므로 구성자에서 updateGeometryO 를 호출하지 않았다 . 그러나 여기서는 QScrollView 기초클 
라스에 작업하려는 초기크기를 주어야 하고 resizeContentsQ 호출에서 이것을 수행한다 . 



void ImageEditor: : resizeContents() 

{ 

QSize size = zoom * curlmage.size(); 
if (zoom >= 3) 

size += QSize(l, 1); 

QScrollView :: resizeContents(size.width(), size.height()); 

} 

resizeContents() 비공개 함수는 QScrollView 의 내용부분의 크기를 넘기여 QScrollView:: 
resizeContentsQ 를 호출한다 . QScrollView 는 보기구역이 내용부분의 어느 위치에 있는가에 따라 
흘림 띠 들을 현시한다 . 

sizeHint() 를 재정의할 필요는 없으며 QScrollView 판은 내용의 크기를 리용하여 합리적인 
크기암시 를 제 공한다 . 

void ImageEditor: :setImage(const Qlmage &newlmage) 

{ 

if (newlmage != curlmage) { 

curlmage = newImage.convertDepth(32); 

curlmage.detach(); 

resizeContents(); 

updateContents(); 



IconEditor 의 많은 원시함수들에서 는 update() 를 호출하여 재 그리 기 를 진 행 하고 
updateGeometryO 를 호출하여 크기암시 변경 을 전달하였다 . QScrollView 판에서는 이 함수호출들 
이 내용의 크기변경에 대하여 QScrcUView 에 통지하는 resizeContents(> 와 재그리기하게 하는 
updateContents() 로 교체된다 . 

void ImageEditor::drawContents(QPainter *painter, int, int, int, int) 

{ 

if (zoom >= 3) { 

painter->setPen(colorGroup().foreground()); 
for (int i = 0; i <= curlmage.width(); ++i) 

painter->drawLine(zoom * i, 0, oom * i, zoom * curlmage .height()); 
for (int j = 0; j <= curlmage.height(); ++j) 

painter->drawLine(0, zoom * j, zoom * curlmage.width(), zoom * j); 

} 

for (int i = 0; i < curlmage.width(); ++i) { 
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for (int j = 0; j < curlmage,height(); ++j) 
drawImagePixel(painter, i, j); 

} 

} 

drawContents () 함수는 QScrollView 에 의 해 호출되 며 내 용의 구역 을 다시 그린다 . QPainter 객 
체는 이 미 홀림변위 를 계산하도록 초기화되 여있다 . 우리 가 보통 paintEventO 에서 와 같이 수행 
할 필요가 있다 . 

2 〜 5 번째 파라메 터 들은 다시 그려야 할 직 4 각형 을 지 정한다 . 이 정 보를 리 용하여 다시 그 
려야 할 직 4 각형만 다시 그릴수 있지만 단순히 모두 다시 그린다 . 

drawContents () 의 마감부근에서 호출되는 drawImagePixelO 함수는 본질상 원래의 IconEditor 
클라스의 함수와 갈으므로 여기서 다시 생성하지 않는다 . 

void ImageEditor::contentsMousePressEvent(QMouseEvent * event) 

{ 

if (event->button() == LeftButton) 
setImagePixel(event->pos(), true); 
else if (event->button() == RightButton) 
setImagePixel(event->pos(), false); 

} 

void ImageEditor::contentsMouseMoveEvent(QMouseEvent *event) 

{ 

if (event->state() & LeftButton) 

setImagePixel(event->pos(), true); 
else if (event->state() & RightButton) 
setImagePixel(event->pos(), false); 

} 

흘림 보기 의 내 용부분들에 대 한 마우스사건 들은 QScroUView 의 특수사건 처 리 함수들을 재 정 
의하여 조종할수 있으며 처리함수의 이름들은 모두 contents 로 시작한다 . 리면에서 
QScrollView 는 자동적으로 보기구역자리표들을 내용자리표들로 변환하므로 자체로 변환할 필 
요는 없다 . 

void ImageEditor::setImagePixel(const QPoint &pos, bool opaque) 

{ 

int i = pos.x() / zoom; 
int j = pos.y() / zoom; 
if (curImage.rect().contains(i, j)) { 
if (opaque) 
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curImage.setPixel(i, j, penColor().rgb()); 
else 

curImage.setPixel(i, j, qRgba(0, 0, 0, 0)); 

QPainter painter(viewport()); 
painter.translate(-contentsX(), -contentsY()); 
drawImagePixel(&painter, i, j); 

} 

} 

setImagePbcel() 함수는 contentsMousePressEvent() 와 contentsMouseMoveEvent() 함수로부터 호 
출되고 화소를 설정하거나 지운다 . 코드는 원래의 판과 거의 같은데 QPainter 객체를 초기화하 
는 방법 이 다르다 . 보기구역 에서 그리기가 수행되므로 부모로서 viewportO 를 넘기고 흘림변위 
에 맞게 QPainter 의 자리표계를 변환한다 . 

QPainter 를 취급하는 3 개 행을 다음 행으로 교체한다 . 
updateContents(i * zoom, j * zoom, zoom, zoom); 

이것은 QScrollView 가 확대된 화상화소가 차지한 자그마한 직 4 각형만 갱신하도록 한다 . 
그러나 필요한 구역만 그리도록 drawContentsO 를 최적화하지 않았으므로 이것으로는 불충분 
하며 QPainter 를 구성하고 그리기를 자체로 수행하는것이 더 좋다 . 

이제 ImageEditor 를 사용한다면 원래판으로부터 QScrollView 창문부품안에서 사용한 
QWidget 에 기초한 IconEditor 를 원래판으로부터 실제로 구별할수 없다 . 그러나 더 복잡한 창문 
부품들에 서 QScrollView 의 파생 클라스화는 더 자연스러 운 수법 이 다 . 례 를 들면 단어 감기 를 실 
현하는 (^TextEdit 와 같은 클라스는 표시 하려는 문서와 QScrollView 사이의 정확한 통합을 요구 
한다 . 

또한 내용이 너무 길거나 폭이 아주 넓으면 QScrollView 의 파생클라스를 만들어야 한다 . 
그것은 일부 창문들이 32,767 화소보다 더 큰 창문부품들을 유지하지 못하기때문이다 . 

ImageEditor 실례 에서 한가지 보여 주지 못한것은 보기 구역 안에 자식 창문부품들을 넣는것 이 
다 . 자식 창문부품들은 단순히 addWidget() 에 의 해 추가되 여 야 하며 moveWidget() 에 의 해 옮길 
수 있다 . 사용자가 내용구역을 흘림띠로 변화시킬 때마다 QScrollView 는 자동적으로 화면우의 
자식 창문부품들을 옳긴다 . 災 ScrollView 가 많은 자식 창문부품들을 포함한다면 흘림 속도는 떠 진 
다 . 이 경우에 enableClipper(tme：) 를 호출하여 최적화할수 있다 .) 이 수법이 의의를 가지는 하나 
의 실례는 웨브열람기 이다 . 대부분의 내용은 보기구역 에 직 접 그려지지만 단추와 그밖의 폼 
입 력 요소들은 자식창문부품들로 표시 된 다 . 

제5절. 류동가능창문 

류동가능창문 (dock window) 은 류동구역에서 류동할수 있는 창문이다 . 도구띠는 류동창문 
의 기본실례이지만 다른 형태들도 있다 . 

QMainWindow 는 4 개의 류동구역을 제공한다 . 즉 창문의 중심 창문부품의 우 , 아래 , 왼쪽 , 
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오른쪽에 각각 하나씩 있다 . QToolBar 들을 창조할 때 그것들은 자동적으로 그 부모의 류동구 
역안에 배 치 된다 . 


[접^^^^^^택 행^^^■三! 

|Helvetica :]|10 jj B / U | ，，身 3 冬 쇼 찬 ♦기 

그림 6-11. 류동가능창문의 띄우기 

매개 류동창문에는 손잡이가 있다 . 이것은 그림 6-12 에 보여주는 각 류동창문의 왼쪽과 
우에 2 개의 재색선들로 나타난다 . 사용자들은 손잡이를 끌어서 한 류동구역에서 다른 류동구 
역으로 류동창문들을 이동할수 있다 . 또한 류동창문을 구역에서 떼내여 류동구역밖으로 끌고 
감으로써 류동창문이 제 일 웃준위창문으로 되 게 할수 있다 . 자유류동창문은 자기 의 제 목띠 와 


닫기단추를 가전 다 . 이 런 


늘 자기 기본창문의 《제 일 우에》있다 . 


그림 6-12. 5 개 의 류동가눙창문을 가지 는 QMainWindow 
류동창문이 떠 오를 때 닫기단추를 삽입 하려 면 다음과 같이 setCloseModeO 를 호출한다 . 

dockWindow->setCloseMode(QDockWindow: : Undocked) ; 

QDockArea 는 모든 류동창문과 도구띠들의 목록을 가지고있는 문맥차림표를 제공한다 . 류 
동창문이 일 단 닫기 면 사용자는 상황차림 표를 리용하여 그것 을 되 살릴수 있다 . 
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그림 6-13. QDockArea 상황차림 표 

류동창문은 QDockWindow 의 파생 클라스이 여 야 한다 . 단추들과 다른 창문부품들을 가지는 
도구띠가 요구된다면 QDockWindow 를 계승하는 QToolBar 를 사용할수 있다 . 여기에 
QComboBox, QSpinBox, 여 러 개의 도구띠 단추들을 포함하는 QToolBar 를 창조하는 방법 과 아래 
류동구역에 그것을 배치하는 방법을 보여준 실례가 있다 . 

QToolBar *toolBar = new QToolBar ( 仕 ("Font"), this); 

QComboBox *fontComboBox = new QComboBox(true, toolBar); 

QSpinBox *fontSize = new QSpinBox(toolBar); 
boldAct->addTo(toolBar); 
italicAct->addTo(toolBar); 
underline Act- 〉 addTo(toolBar); 
moveDockWindow(toolBar, DockBottom); 

이 도구띠는 QComboBox 와 QSpinBox 가 너무 큰 수평공간을 요구하므로 사용자가 
QMainWindow 의 왼쪽이나 오른쪽 류동구역들로 도구띠를 이동한다면 좋지 않게 보일수 있다 . 
이러한 현상을 방지하기 위하여 QMainWindow :: setDockEnabledO 를 다음과 같이 호출할수 있 
다 . 


setDockEnabled(toolBar, DockLeft, false); 
setDockEnabled(toolBar, DockRight, false); 

필요한것 이 류동창문부품이 나 도구조색 판과 같은것 이 라면 직 접 QDockWindow 를 리 용하여 
setWidget() 를 호출하고 창문부품을 QDockWindow 안에 표시 되 도록 설 정할수 있 다 . 그러 면 창 
문부품은 복잡해질수 있다 . 사용자가 류동창문이 류동구역안에 있는 경우에도 류동창문의 크 
기를 조절하게 하려면 류동창문에서 setResizeEnabled() 를 호출하면 된다 . 그러면 류동창문의 
측면에 분할기와 같은 손잡이가 나타나게 된다 . 

창문부품이 수평 혹은 수직 류동구역안에 놓이 는가에 따라서 자체 를 변경 하려 고 한다면 
QDockWindow::setOrientation() 를 재 정 의 하고 거 기 서 변 경 한다 . 

모든 도구띠와 다른 류동창문들의 위치를 보관하여 응용프로그람이 다시 실행될 때 그것 
들을 되살릴수 있게 하려면 QSplitter 의 상태를 보관할 때 사용한 코드와 비슷하게 
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QMainWindow 의 « 연산자로 상태를 써넣고 QMainWindow 의 >>연산자로 그것을 다시 읽어들 
이는 코드를 쓸수 있다 . 

Microsoft Visual Studio 와 Qt Designer 와 같은 응용프로그람들은 류동창문들을 널리 리 용하 
여 아주 유연한 사용자대면부를 제공한다 . 보통 어에서 이러한 종류의 사용자대면부는 많은 
사용자정 의 QDockWindow 들과 함께 중간에 Mm 자식 창문들을 조종하기 위 한 하나의 
QWorkspace 를 가지는 QMainWindow 를 리용하여 작성한다 . 

제6절. 다중문서대면부 

기 본창문의 중심 구역 에 여 러개의 문서를 제공하는 응용프로그람들은 다중문서대면부 응 
용프로그람이 라고 부론다 . Qt 에서 MDI 응용프로그람은 QWorkspace 클라스에 의 하여 중심 창문부 
품으로서 창조되 고 매 개 문서창문을 QWorkspace 의 자식 으로 만든다 . 

보통 MDI 응용프로그람은 창문들과 창문들의 목록을 관리하는 지령들을 포함하는 
Windows 차림표를 제공한다 . 능동창문은 검사표식을 가지고 식별한다 . 사용자는 Windows 차림 
표에서 창문의 항목을 찰칵하여 그 창문을 능동으로 만들수 있다 . 

이 절에서는 그림 6-14 에 보여주는 Editor 응용프로그람을 개발하여 MDI 응용프로그람을 창 
조하는 방법과 그 Windows 차림표를 실현하는 방법을 보여준다 . 
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MainWindow: : MainWindow(QWidget ^parent, const char *name) : QMainWindow(parent, name) 

{ 

workspace = new QWorkspace(this); 
setCentralWidget(workspace); 

connect(workspace, SIGNAL(windowActivated(QWidget *)), this, SLOT(updateMenus())); 
connect(workspace, SIGNAL(windowActivated(QWidget *)), this, 
SLOT(updateModIndicator())); 
create Actions。; 
createMenus(); 
createToolBars(); 
create StatusBar(); 
setCaption(tr( ,, Editor f, ))； 

setIcon(QPixmap::fromMimeSource("icon.png")); 

} 

MainWindow 구성 자에 서 는 QWorkspace 창문부품을 창조하여 중심 창문부품으로 만든다 . 
(^Workspace 의 windowActivatedO 신호를 2 개의 비공개처 리부들에 련결한다 . 이 처 리부들은 차림 
표와 상태띠 가 늘 현재 능동인 자식창문의 상태를 반영 한다는것 을 담보한다 . 
void MainWindow :: newFile() 

{ 

Editor * editor = createEditor(); 
editor->newF ile(); 
editor->show(); 

} 

newFileO 처 리 부는 File|New 차림 표선 택 에 대 응된다 . 이 것 은 createEditorQ 비 공개 함수에 따라 
서 자식 Editor 창문을 창조한다 . 

Editor *MainWindow: :createEditor() 

{ 

Editor * editor = new Editor(workspace); 

connect(editor, SIGNAL(copyAvailable(bool)), this, SLOT(copyAvailable(bool))); 
connect(editor, SIGNAL(modificationChanged(bool)),this, SLOT(updateModIndicator())); 
return editor; 

} 

createEditor() 함수는 Editor 창문부품을 창조하고 2 개 의 신호-처 리 부련 결 을 설 정한다 . 첫 째 
련결은 Edit|Cut 와 Edit|Copy 가 선택된 본문이 있는가 없는가에 따라 허용 혹은 금지되도록 
한다 . 둘째 련결은 상태띠의 MOD 지시자가 늘 최근의 상태를 반영하도록 한다 . 



MDI 를 사용하므로 여러개의 Editor 창문부품들을 사용할수 있다 . 이것은 오직 능동인 
Editor 창문으로부터 오는 copyAvailable(bool) 과 modificationChanged() 신호들에 응답하는데만 관 
심을 가지는것과 관련된다 . 그러나 이 신호들은 능동창문에만 발생될수 있으므로 실제로 문 
제는 없다 . 

void MainWindow::open() 

{ 

Editor * editor = createEditor(); 
if (editor->open()) 
editor->show(); 



} 

openO 함수는 File|Open 에 대응된다 . 이것은 새 문서에 대하여 새로운 Editor 를 창조하고 
Editor 에 대하여 open() 을 호출한다 . 매개 Editor 가 자체의 독립적인 상태를 관리해야 하므로 
MainWindow 클라스에서가 아니라 Editor 클라스에서 파일조작을 실현하는것이 더 좋다 . open() 이 
실폐하면 사용자가 이 미 오유를 통지받았으므로 편집 기 를 닫는다 . 
void MainWindow ::save() 

{ 

if (activeEditor()) { 

activeEditor()->save(); 
updateModIndicator(); 

} 

} 

saveO 처리부는 능동편집기가 있으면 그것에 대하여 saveO 를 호출한다 . 또한 실제의 작업 
을 수행하는 코드는 Editor 클라스에 서술된다 . 

Editor *MainWindow :: activeEditor() 

{ 

return (Editor *)workspace->activeWindow(); 

} 

activeEditor() 비 공개 함수는 능동자식 창문을 Editor 지 적 자로서 돌려 준다 . 
void MainWindow::cut() 

{ 



activeEditor()->cut(); 

} 
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cut() 처리부는 능동편집기에 대하여 cut() 를 호출한다 . copy(), paste(), del() 처리부들도 같은 
형태를 가진다 . 

void MainWindow: : updateMenus() 

{ 

bool hasEditor = (activeEditor() != 0); 
save Act->setEnabled(hasEditor); 
saveAsAct->setEnabled(hasEditor); 
pasteAct->setEnabled(hasEditor); 
deleteAct->setEnabled(hasEditor); 

copyAvailable(activeEditor() && activeEditor()->hasSelectedText()); 

closeAct->setEnabled(hasEditor); 

closeAllAct->setEnabled(hasEditor); 

tileAct->setEnabled(hasEditor); 

cascadeAct->setEnabled(hasEditor); 

nextAct->setEnabled(hasEditor); 

previousAct->setEnabled(hasEditor); 

windowsMenu->clear(); 

create WindowsMenu(); 

} 

updateMenusQ 처리 부는 창문이 능동으로 될 때마다(혹은 마지막 창문이 닫길 때 ) 호출되 여 
차림표체계를 갱신한다 . 이때 MainWindow 구성 자에 배치한 신호-처 리부련결을 리 용한다 . 

대부분의 차림표선택은 능동창문이 있어야 의미를 가지므로 능동창문이 없으면 금지된다 . 
그다음 Windows 차림 표를 지 우고 createWindowsMenu() 를 호출하여 새 로운 자식 창문목록으로 
다시 초기화한다 . 

void MainWindow: : createWindowsMenu() 

{ 

closeAct->addTo(windowsMenu); 
closeAllAct->addTo(windowsMenu); 
windowsMenu->insertSeparator(); 
tileAct->addTo(windowsMenu); 
cascadeAct->addTo(windowsMenu); 
windowsMenu->insertSeparator(); 
nextAct->addTo(windowsMenu); 
previousAct->addTo(windowsMenu); 
if (activeEditorQ) { 
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windowsMenu->insertSeparator(); 

windows = workspace->windowList(); 

int numVisibleEditors = 0; 

for (int i = 0; i < (int)windows.count(); ++i) { 

QWidget *win = windows.at(i); 
if (!win->isHidden()) { 

QString text = tr("%l %2") .arg(numVisibleEditors + 1) .arg(win->caption()); 
if (numVisibleEditors < 9) 
text.prepend( M & n ); 

int id 다 windowsMenu->insertItem( text, this, SLOT(activateWindow(int))); 
bool isActive = (activeEditor() = win); 
windowsMenu->setItemChecked(id, isActive); 
windowsMenu->setItemParameter(id, i); 

++numVisibleEditors; 

} 

} 

} 

} 

createWindowsMenuO 비공개 함수는 Windows 차림표를 작용들과 보이는 창문들의 목록으로 
채운다 . 이 작용들은 모두 차림표의 전형으로서 QWorkspace 의 closeActiveWindow(), 
closeAllWindows(), tile(), cascade() 처 리 부들에 의 해 간단히 실 현된다 . 

능동창문의 항목은 그 이름옆에 검사표식이 있다 . 사용자가 창문항목을 선택할 때 
setltemParameterO 호출에 의하여 activateWindow() 처리부가 창문목록의 첨수를 파라메터로 하여 
호출된다 . 이것은 3 장에서 표계산프로그람의 최근에 연 파일목록을 실현할 때와 아주 비슷하 
다 . 

처음 9 개의 항목에 대하여 수자앞에 & 기호를 배치하여 그 수의 한자리를 지름건으로 만 
든다 . 다른 항목들에는 지름건을 주지 않는다 . 
void MainWindow: : activateWindow(int param) 

{ 

QWidget *win = windows.at(param); 

win->show(); 

win->setFocus(); 

} 

activateWindow() 함수는 창문이 Windows 차림표에서 닫길 때 호출된다 . int 파라메터는 
setltemParameterO 에 의해 설정되는 값이다 . windows 자료성원은 창문들의 목록을 보관하고 
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createWindowsMenu() 에서 설정된다 . 

void MainWindow: :copyAvailable(bool available) 

{ 

cutAct->setEnabled(available); 
copyAct->setEnabled(available); 

} 

copyAvailable() 처리부는 편집기에서 본문을 선택하거나 선택이 해제될 때마다 호출된다 . 
또한 updateMenus() 로부터 호출된다 . 이것은 자르기와 복사작용을 허용하거나 금지한다 . 
void MainWindow: : updateModIndicator() 

{ 

if (activeEditor() && activeEditor()->isModified()) 
modLabel->setText(tr( n MOD")); 

else 

modLabel->clear(); 

} 

updateModlndicatorO 는 상태띠의 MOD 지시자를 갱신한다 . 이것은 편집기에서 본문이 수정 
될 때마다 호출된다 . 또한 새 창문이 능동으로 될 때 호출된다 . 
void MainWindow : : closeEvent(QCloseEvent * event) 

{ 

workspace->closeAllWindows(); 
if (activeEditor()) 
event->ignore(); 

else 


event->accept(); 

} 

closeEvent() 함수는 모든 자식 창문을 닫도록 재 정 의 된 다 . 대 체 로 사용자가 "unsaved 
changes" 통보창에서 취 소하여 하나의 자식창문부품이 그의 닫기 사건을 《 무시》하면 
MainWindow 의 닫기사건을 무시하고 그렇지 않으면 그것을 받아들이며 그 결과 (가는 창문을 
닫는다 . MainWindow 에서 closeEvent() 를 재정의하지 않았으면 사용자에게는 보관하지 않은 변 
경을 보관할 기회가 주어지지 않는다 . 

이제는 MainWindow 의 설명을 끝냈으므로 Editor 실현에로 넘어갈수 있다 . Editor 클라스는 
하나의 자식창문을 표시한다 . 이것은 본문편집기능을 제공하는 QTextEdit 를 계승한다 . 임의의 
Qt 창문부품이 독립창문으로 쓰일수 있듯이 임 의의 Qt 창문부품을 MDI 작업 공간에서 자식창문 
으로 사용할수 있다 . 

여기에 클라스정의가 있다 . 
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class Editor : public QTextEdit 

{ 

Q_OBJECT 

public: 

Editor(QWidget ^parent = 0, const char *name = 0); 
void newFile(); 
bool open(); 

bool openFile(const QString &fileName); 
bool save(); 
bool saveAs(); 

QSize sizeHint() const; 
signals: 

void message(const QString &fileName, int delay); 
protected: 

void closeEvent(QCloseEvent *event); 
private: 

bool maybeSave(); 

void saveFile(const QString &fileName); 
void setCurrentFile(const QString &fileName); 

QString strippedName(const QString &fullFileName); 
bool readFile(const QString &fileName); 
bool writeFile(const QString &fileName); 

QString curFile; 
bool isUntitled; 

QString fileFilters; 

}； 

표계산프로그람의 MainWindow 클라스에 있는 4 개의 비공개함수 즉 maybeSave(), saveFile(), 
setCurrentFile(), strippedName () 을 Editor 클라스에서도 포함한다 . 

Editor: : Editor(QWidget ^parent, const char *name) : QTextEdit(parent, name) 

{ 

setWFlags(WDestructiveClose); 
setIcon(QPixmap::fromMimeSource("document.png M )); 
isUntitled = true; 

fileFilters = tr("Text files (*.txt)\n n "All files (*)"); 


} 
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Editor 구성 자는 setWFlagsQ 에 의 하여 WDestructiveClose 기 발을 설정 한다 . 클라스구성 자가 
기발파라메터를 제공하지 않을 때 ((^TextEdit 의 경우처럼 ) 여전히 setWFlagsG 에 의하여 대부분 
의 기발을 설정할수 있다 . 

사용자들이 임의의 개수의 편집기 창문들을 창조할수 있으므로 편집기 창문들의 이름지을 
준비를 하여 처음으로 그것들을 보관하기전에 구별할수 있다 . 이것을 취급하는 일반적인 방 
법의 하나는 수를 포함하는 이름을 할당하는것이다 . (례를 들면 documentl.txt). isUntitled 변수를 
리용하여 사용자가 제공한 이름들과 프로그람적으로 창조한 이름들을 구별한다 . 

구성자후에 newFile() 이나 open() 의 호출을 기대한다 . 
void Editor: :newFile() 

{ 

static int documentNumber = 1; 

curFile = 仕 ("document% l.txt’’).arg(documentNumber); 

setCaption(curFile); 

isUntitled = true; 

++documentNumber; 

} 

newFileO 함수는 새 문서에 대하여 document2.txt 와 같은 이름을 생성 한다 . 코드는 구성자 
가 아니라 newFile() 에 포함된다 . 그것은 새로 창조한 Editor 에서 현존 문서를 열기 위하여 
openQ 을 호출할 때 문서번호를 증가시키려고 하지 않기때문이다 . documentNumber 가 static 로 
선언되므로 이것은 Editor 의 모든 실례들에서 공유된다 . 
bool Editor: :open() 

{ 

QString fileName = QFileDialog::getOpenFileName( n .", fileFilters, this); 
if (fileName.isEmptyO) 
return false; 

return openFile(fileName); 

} 

openO 함수는 openFileO 을 리용하여 현존파일을 연다 . 
bool Editor: :save() 

{ 

if (isUntitled) { 

return saveAs(); 

} else { 

saveFile(curFile); 
return true; 


167 



} 

} 

save() 함수는 isUntitled 변수를 리용하여 saveFile() 을 호출해야 하는가 saveAs() 를 호출해야 
하는가를 결 정한다 . 

void Editor: : closeEvent(QCloseEvent *event) 

{ 

if (maybeSave()) 

event->accept(); 

else 


event->ignore(); 

} 

closeEventO 함수는 사용자가 보관안된 변경을 보관하도록 재정의된다 . maybeSave() 함수는 
"Do you want to save your changes?，’ 를 묻는 통보창을 펼 친 다 . maybeSave() 가 true 를 돌려 주면 닫 
기사건을 받아들이고 그렇지 않으면 그것을 무시하고 창문은 그대로 남아있다 . 
void Editor: : setCurrentFile(const QString &fileName) 

{ 

curFile = fileName; 
setCaption(strippedName(curFile)); 
isUntitled = false; 
setModified(false); 

} 

setCurrentFile() 함수는 openFile() 와 saveFile() 로부터 호출되여 curFile 와 isUntitled 변수들을 
갱신하고 창문제목을 설정하며 편집기의 《수정》기발을 false 로 설정한다 . Editor 클라스는 
QTextEdit 로부터 setModified() 와 isModified() 를 계승하므로 자체의 변경기발을 관리할 필요는 
없다 . 사용자가 편집기의 본문을 수정할 때마다 QTextEdit 는 modificationChanged() 신호를 발생 
하고 그 내 부수정 기 발을 true 로 설 정한다 . 

QSize Editor::sizeHint() const 

{ 

return QSize(72 * fontMetrics().width( , x , ), 25 * fontMetrics().lineSpacing()); 

} 

sizeHintO 함수는 문자 V 의 폭과 본문행의 높이에 기초하는 크기를 돌려준다 . (^Workspace 
는 크기암시 를 사용하여 창문의 초기 크기 를 준다 . 

끝으로 Editor 응용프로그람의 mainxpp 파일을 보기로 하자 . 

#include <qapplication.h> 

#include "mainwindow.h” 
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int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

MainWindow mainWin; 
app. setMainWidget(&mainWin); 
if (argc > 1) { 

for (int i = l;i < argc;++i) 
mainWin.openFile(argv[i]); 

} else { 

mainWin.newFile(); 

} 

mainWin. show(); 
return app.exec(); 

} 

사용자가 지령행에서 임의의 파일들을 지정하면 그것들을 적재하려고 시도한다 . 그렇지 
않으면 빈 문서로 시 작한다 . - style 및 -font 와 같은 Qt 에 고유한 지 령 행선택은 QApplication 구성 
자에 의해 인수목록으로부터 자동적으로 삭제된다 . 그러므로 지령행에 
editor -style=motif readme.txt 

과 같이 쓰면 Editor 응용프로그람은 하나의 문서 readme.txt 를 가지고 기동한다 . 

MDI 는 여러개의 문서를 동시에 취급하는 하나의 수법이다 . 다른 수법은 여러개의 제일 
웃준위창문들을 리 용하는것 이 다 . 이 수법 은 3 장의 7 절 에 서 설 명한다 . 




제 7 장. 사건처리 

GUI 응용프로그람들은 사건구동형 이다 . 즉 응용프로그람이 기동하면 발생하는것은 사건의 
결과이 다 . Qt 로 프로그람을 작성할 때 어떤 일 이 발생하면 Qt 창문부품들이 신호들을 발생하므 
로 사건에 대하여 고찰할 필요가 있다 . 사건은 자체의 사용자정의창문부품을 쓰거나 현존 Qt 
창문부품들의 동작을 수정하려고 할 때 사용할수 있다 . 

이 장에서는 Qt 의 사건모형을 설명한다 . 우리는 어에서 각이한 형의 사건을 다루는 방법 
을 알게 된다 . 또한 사건려과기를 리용하여 사건이 자기 목적지에 이르기전에 그것을 조종하 
는 방법을 고찰한다 . 끝으로 Qt 의 사건순환고리를 시험하고 긴장한 처리를 하는 동안에 사용 
자대면부가 응답하게 하는 방법을 설명한다 . 

제1절. 사건처리함수의 재정의 

사건은 여러가지 정황에 따라서 창문체계나 짯에 의해 생성된다 . 사용자가 건사건이나 마 
우스단추를 누르거나 놓으면 건이나 마우스사건이 생성된다 . 창문이 이동하여 가리워졌던 다 
른 창문이 로출될 때 그리기사건이 생성되여 새로 보이는 창문에 다시 그리기하여야 한다는 
것을 알려준다 . 또한 사건은 창문부품이 건반초점을 얻거나 잃을 때마다 생성된다 . 대부분의 
사건은 사용자의 작용에 응답하여 생성되지만 시계사건 등 일부는 체계에 의해 독립적으로 
생성된다 . 

사건을 신호와 혼돈하지 말아야 한다 . 신호는 창문부품을 리용할 때 필요하지만 사건은 
창문부품을 실현할 때 필요하다 . 례를 들면 QPushButton 을 사용하고있을 때 신호를 발생하는 
저 수준마우스사건이 나 건사건보다도 그 clickedO 신호에 더 관심을 가진다 . 그러 나 QPushButton 
과 같은 클라스를 실현하고있으면 마우스와 건사건들을 조종하고 필요할 때 clickedO 신호를 
발생하는 코드를 써야 한다 . 

사건은 QObject 로부터 계승된 event () 함수를 통하여 객체들에 통지된다 . QWidget 에서 
event () 실 현 은 mousePressEvent(), keyPressEvent(), paintEvent () 와 같은 특정 한 사건 처 리 함수들에 
가장 보편적 인 형태 이고 다른 종류의 사건들은 무시한다 . 

앞장들에서 MainWindow, IconEditor, Plotter, ImageEditor, Editor 를 실 현할 때 이 미 많은 사건 
처 리 함수들을 보았다 . 다른 형의 사건들이 많으며 QEvent 참고문서 에 렬거되 여있다 . 또한 사용 
자정 의사건형 들을 창조하고 사용자정 의 사건들을 자체 로 발송할수 있다 . 사용자정 의 사건들은 
다중스레 드응용프로그람들에 서 특별 히 편 리 하므로 17 장(다중스레 드작성 )에 서 설 명한다 . 여 기 
서 는 2 가지 사건 형 즉 건 사건 들과 시 계 사건 들을 설 명한다 . 

건사건들은 keyPressEvent () 와 keyReleaseEvent () 를 재정 의 하여 처 리 한다 . Plotter 창문부품은 
keyPressEvent () 를 재정의한다 . 보통 놓기 에서 중요한 건이 란 수식건 Cttl, Shift, Alt 이고 이 건들 
은 state () 를 사용하여 keyPressEventO 에서 검사할수 있으므로 keyPressEventO 를 재정 의할 필요 
만 있다 . 례를 들면 CodeEditor 창문부품을 실현하는 경우에 Home 과 Cttl+Home 사이를 구별하 
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는 keyPressEventO 는 다음과 같을수 있다 . 

void CodeEditor::keyPressEvent(QKeyEvent * event) 

{ 

switch (event->key()) { 
case Key Home: 

if (event->state() & ControlButton) 
goToBeginningOfDocument(); 
else goToBeginningOfLine(); 
break; 

case Key_End: ... 
default: 

QWidget: :keyPressEvent(event); 



Tab 와 Backtab(Shift+Tab) 건들은 특수한 경우이다 . 이것들은 초점사슬에서 다음 또는 이전 
의 창문부품으로 초점을 넘긴다는 의미에서 keyPressEventO 를 호출하기전에 QWidget::event() 에 
의해 처리된다 . 이 동작은 보통 경우에는 맞지만 CodeEditor 창문부품에서는 Tab 를 사용하여 
행의 들여쓰기를 진행한다 . 그때 event() 재정의는 다음과 같다 . 
bool CodeEditor: : event(QEvent * event) 

{ 

if (event->type() == QEvent: : KeyPress) { 

QKeyEvent *keyEvent = (QKeyEvent *)event; 
if (keyEvent->key() == Key Tab) { 
insertAtCurrentPosition( , \t , ); 
return true; 

} 

} 

return QWidget: : event(event); 

} 

사건 이 건 누르기 이 면 QEvent 객 체 를 QKeyEvent 로 강제 변 환하고 어 느 건 이 눌러졌는가를 
검사한다 . 건이 Tab 이면 그에 대한 처 리를 수행하고 true 를 돌려주어 Qt 에게 사건을 처 리했다 
고 알린다 . false 를 돌려주었으면 Qt 는 사건을 부모창문부품에 전달한다 . 

건속박을 실현하는 고급한 수법은 QAction 을 사용하는것이다 . 례를 들면 
goToBeginningOfLine() 과 goToBeginningOfDocument() 가 CodeEditor 창문부품에서 공개처리부들이 
고 CodeEditor 가 MainWindow 클라스의 중심 창문부품으로 사용된 다면 다음의 코드로 건 결 합을 
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추가할수 있다 . 


MainWindow: : MainWindow(QWidget *parent, const char *name) : QMainWindow(parent, name) 

{ 

editor = new CodeEditor ( 仕 lis); 
setCentralWidget(editor); 

goToBeginningOfLineAct = new QAction(tr(’’Go to Beginning of Line”), tr(’’Home"), this); 
connect(goToBeginningOfLineAct, SIGNAL(activatedO), editor, 
SLOT(goToBeginningOfLine())); 

goToBeginningOfDocumentAct = new QAction(tr("Go to Beginning of Document"), 
tr("Ctrl+Home n ), this); 

connect(goToBeginningOfDocumentAct, SIGNAL(activated()), editor, 
SLOT(goToBeginningOfDocument())); 


} 

이것은 3 장에서 본것처럼 차림표나 도구띠에 지령들을 간단히 추가하게 한다 . 지령이 사 
용자대면부에 나타나지 않으면 QAction 객체들은 건결합을 유지하기 위하여 내적으로 QAction 
에 의해 사용되는 클라스인 QAccel 객체로 교체된다 . 

keyPressEvent() 재정의와 QAction (혹은 QAccel) 사용사이의 선택은 resizeEvent() 재정의와 
QLayout 과생 클라스사용사이의 선택과 비 슷하다 . QWidget 의 과생 클라스를 만들어 사용자정의 창 
문부품을 실현한다면 일부 사건처 리함수들을 재정의하고 거기 에 동작코드를 간단히 쓸수 있 
다 . 그러나 단지 창문부품을 사용한다면 QAction 과 QLayout 에 의해 제공되는 고수준대면부들 
이 더 편리하다 . 

또 하나의 일반사건은 시계사건이다 . 대부분의 사건은 사용자작용의 결과로 발생하지만 
시계사건은 응용프로그람이 규칙적인 시격으로 처리를 수행하게 한다 . 시계사건은 유표의 깜 
빡거림이 없는 동화를 실현하거나 현시기를 초기화하는데 쓰일수 있다 . 

시계사건을 보여주기 위하여 Ticker 창문부품을 실현한다 . 이 창문부품은 30ms 마다 1 화소 
씩 왼 쪽으로 흘러 가는 본문띠 (banner) 를 표시 한다 . 창문부품의 폭이 본문보다 더 넓 으면 본문 
은 창문부품의 전체폭을 채우도록 필요한만큼 반복된다 . 

sible to say ++ How long it lasted was impossible to say ++ Hov long it lastc 

그림 7-L Ticker 창문부품 

여기에 머리부파일이 있다 . 

#ifndef TICKER H 
#defme TICKER H 
#include <qwidget.h> 
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class Ticker : public QWidget 

{ 

Q_OBJECT 

Q_PROPERTY(QString text READ text WRITE setText) 
public: 

Ticker(QWidget ^parent = 0， const char *name = 0); 
void setText(const QString &newText); 

Q String text() const { return myText;} 

QSize sizeHint() const; 
protected: 

void paintEvent(QPaintEvent *event); 
void timerEvent(QTimerEvent *event); 
void showEvent(QShowEvent *event); 
void hideEvent(QHideEvent *event); 
private: 

QString myText; 
int offset; 
int myTimerld; 

}； 

#endif 

Ticker 에서 4 개의 사건처리함수를 재정의하고 그중 3 개는 이전에 보지 못한것으로서 
timerEvent(), showEvent(), hideEvent() 이 다 . 

그러면 실현을 고찰하자 . 

#include <qpainter.h> 

#include "ticker.h" 

Ticker: : Ticker(QWidget ^parent, const char *name) : QWidget(parent, name) 

{ 

offset = 0; 
myTimerld = 0; 

} 

구성자는 offset 변수를 0 으로 초기화한다 . 본문을 그리는 x 자리표는 offset 값으로부터 끌어 
낸다 . 

void Ticker: : setText(const QString &newText) 


myText = newText; 
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update(); 

updateGeometry(); 


} 

setTextO 함수는 표시하려는 본문을 설정한다 . 이 함수는 updateO 를 호출하여 다시그리게 
하고 updateGeom 的 y () 를 호출하여 Ticker 창문부품에 응답할수 있는 배 치 관리 자에 크기 암시 변 
경 을 통지한다 . 

QSize Ticker::sizeHint() const 

{ 

return fontMe 仕 ics().size(0 ， text()); 

} 

sizeHintO 함수는 본문이 요구하는 공간을 창문부품의 리상크기로서 돌려준다 . 

QWidget :: fontMetrics () 함수는 창문부품의 서체관련정보를 얻기 위한 질문을 처리 할수 있는 
QFontM 的 ics 객체를 돌려준다 . 이 경우에 주어진 본문이 요구하는 크기를 묻는다 . 
void Ticker: : paintEvent(QPaintEvent *) 

{ 

QPainter painter(this); 

int textWidth = fontMetrics().width(text()); 

if (textWidth < 1) 
return; 

int x = -offset; 

while (x < width()) { 

painter.drawText(x, 0, textWidth, height(), AlignLeft | AlignVCenter, text()); 
x += textWidth; 

} 

} 

paintEvent () 함수는 QPainter::drawText () 에 의해 본문을 그린 다 . 이 함수는 fontM 的 'icsO 를 리 
용하여 본문이 요구하는 수평공간이 얼마나 되는가를 확정하고 필요한만큼 본문을 여러번 그 
리며 변위를 고려하여 창문부품의 전체폭을 완전히 채운다 . 
void Ticker::showEvent(QShowEvent *) 

{ 

myTimerld = startTimer(30); 

} 

showEventO 함수는 시계를 기동한다 . QObject::stortTimerO 호출은 正)번호를 돌려주는데 이것 
은 후에 시계를 식 별하는데 사용된다 . QObject 는 자체의 시격을 가지는 여 러개의 독립적 인 시 
계들을 유지한다 . startTimerO 호출후에 어는 시 계사건을 약 30ms 간격 으로 생성한다 . 이때 정 확 
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성은 기초하고있는 조작체계에 의존한다. 

Ticker 구성자에서 startTimer () 를 호출할수 있으나 창문부품이 실제로 보일 때에만 Qt 가 시 
계사건들을 생성하게 하여 자원을 절약할수 있다. 

void Ticker : : timerEvent(QTimerEvent * event ) 

{ 

if ( event -> timerld () == myTimerld ) { 

++ offset ; 

if (offset >= fontMetrics (). width ( text ())) 
offset = 0; scroll (- l , 0); 

} else { 

QWidget : : timerEvent ( event ); 

} 

} 

timerEventO 함수는 체계 에 의하여 갈은 간격으로 호출된다. 시 격은 본문폭까지의 이동을 
모의 하기 위해 변위 를 1씩 증가시 킨다. 그다음 QWidget :: scroll () 에 의하여 창문부품내용을 1화 
소 왼쪽으로 흘림한다. scroll () 대신에 update () 를 호출하면 충분한것 같지만 scroll () 이 더 효과있 
고 깜빡거림을 방지한다. 그것은 scrollO 이 화면우의 현존화소들을 단순히 이동하고 창문부품 
의 새로 로출된 구역(이 경우에 1화소폭의 띠)에 대하여서만 그리기사건을 생성하기때문이다. 

만일 시 계사건처 리 를 진행하지 않으려면 그것을 기 초클라스에 넘 긴다. 

void Ticker : : hideEvent(QHideEvent *) 

{ 

killTimer ( myTimerId ); 

} 

hideEvent () 함수는 QObject :: killTimer () 를 호출하여 시 계를 중지 한다. 

시계사건들은 저수준이고 여러개의 시계가 요구되면 시계 ID 들을 추적하여 보관하는것이 
불편하다. 그러 한 상황에 보통 매개 시계 에 대하여 QTimer 객체를 창조하는것 이 더 편리하다. 
QTimer 는 매 시 격 마다 timeout () 신 호를 발생 한다. 또한 QTimer 는 단일 발사시 계 (한번 만 시 간을 
요구하는 시 계)에 편리한 대 면부를 제공한다. 

제2절. A ᅡ건려고ᅡ기의 설치 

Qt 사건모형의 한가지 강력한 특성은 어떤 QObject 실례가 자기 사건들을 알아보기전에 다 
른 QObject 실 례 가 그 사건 들을 감시 하도록 설 정할수 있는것 이 다. 

여러개의 QLineEdit 들로 구성된 CustomerlnfoDialog 창문부품이 있고 Space 건으로 초점을 
다음 QLineEdit 로 옮기려고 한다고 하자. 이것은 QLineEdit ^ 파생 클라스를 만들고 
keyPressEvent () 를 재정의하여 focusNextPrevChild () 를 호출함으로써 실현할수 있다. 

void MyLineEdit :: keyPressEvent(QKeyEvent * event ) 
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if (event->key() == Key Space) 
focusN extPrevChild(true); 

else 


QLineEdit: : keyPressEvent(event); 

} 

이 수법에는 많은 결함이 있다 . MyLineEdit 가 표준 Qt 클라스가 아니므로 그것을 사용하는 
폼을 설계 하려면 Qt Designer 에 통합되여야 한다 . 또한 폼에서 각종 창문부품(례 를 들면 
QComboBoxe 와 QSpinBoxe ) 들을 여 러개 사용한다면 그것들을 파생클라스로 만들어 같은 동작 
을 보여 주게 하고 Qt Designer 에 통합하여 야 한다 . 

더 좋은 해결책은 CustomerlnfoDialog 가 자식 창문부품들의 건누르기사건들을 감시하게 하 
고 감시코드에 필요한 동작을 실현하는것이다 . 이것은 사건려과기에 의해 달성된다 . 사건려과 
기는 2 단계에 걸쳐 설치한다 . 

① 목표에 대하여 installEventFilterO 를 호출하여 목표객체와 함께 감시객체를 등록한다 . 

② 감시 기 의 eventFilter () 함수에 서 목표객 체 의 사건 들을 처 리 한다 . 

감시객체를 등록하는 좋은 위치는 CustomerlnfoDialog 구성자이다 . 

CustomerlnfoDialog :: CustomerInfoDialog(QWidget ^parent, const char *name) 

: QDialog(parent, name) 

{ 


firstNameEdit->installEventFilter(this); 
lastNameEdit->installEventF ilter(this); 
cityEdit->installEventFilter(this); 
phoneNumberEdit->installEventF ilter(this); 

} 

사건 려 과기 가 등록되 면 firstNameEdit, lastNameEdit, cityEdit, phoneNumberEdit 창문부품들 에 
송신되는 사건들은 자기 의 예 정된 목적지 에 송신되 기전에 CustomerlnfoDialog 의 eventFilter () 함 
수에 우선 송신된다 . (여러개의 사건려과기가 같은 객체에 설치되여있으면 려과기들은 제일 
최근에 설치된것부터 차례로 능동화된다 .:) 

여기에 사건들을 받아들이는 evenffilterO 함수가 있다 . 

bool CustomerlnfoDialog :: eventF ilter(QObj ect * target, QEvent *event) 

{ 

if (target = firstNameEdit || target = lastNameEdit 

|| target == cityEdit || target == phoneNumberEdit) { 
if (event->type() == QEvent: : KeyPress) { 





QKeyEvent *keyEvent = (QKeyEvent *) event ; 
if ( keyEvent -> key () == Key Space ) { 
focusNextPrevChild ( true ); 
return true ; 

} 

} 

} 

return QDialog : : evenFilter ( target , event ); 

} 

우선 목표창문부품이 QLineE 出 t 들중 하나인가 검사한다. 기초클라스 QDialog 는 자기의 창 
문부품들을 감시 할수 있다. (Qt 3.2 에서 이 것은 QDialog 의 경 우가 아니 다. 그러 나 
QMainWindow 와 같은 다른 Qt 창문부품클라스들은 여 러 가지 리 유로 자기 의 일 부 자식 창문부 
품들을 감시한다.) 

사건이 건누르기 이면 그것을 QKeyEvent 로 강제변환하고 어느건을 눌렀는가 검사한다. 누 
른 건이 Space 이면 focusNex 任 1 revChild () 를 호출하여 초점을 초점사슬의 다음 창문부품에 넘기 
고 true 를 돌려주어 Qt 에게 사건을 처리하였다는것을 알린다. false 를 돌려주면 Qt 는 사건을 예 
정한 목표에 보내고 결과 공백 의 가상코드가 QLineEdit 에 삽입 된다. 

사건이 Space 건누르기가 아니면 조종을 eventFilter () 의 기초클라스실현에 넘긴다. 

Qt 는 사건들을 처리하고 려과하는 5개의 준위를 제공한다. 

① 특정한 사건처 리함수를 재 정의할수 있다. 

mousePressEvent (), keyPressEventO , paintEvent () 와 같은 사건처 리 함수들의 재정의 는 사건들을 
처 리 하는 가장 일반적 인 방법 이 다. 이 미 그러한 실례를 여 러 개 보았다. 

② QObject :: event () 를 재정 의할수 있다. 

event () 함수를 재정의함으로써 사건이 특정한 사건처리함수들에 도달하기전에 처리된다. 
이 수법은 처음에 보여준것처럼 Tab 건의 기정의미를 무시하는데 대체로 필요하다. 이것은 또 
한 특정 한 사건 처 리 함수가 존재 하지 않는 사건(례 를 들면 LayoutDirectionChange ) 들처 럼 드물 
게 나타나는 사건들을 처리하는데 쓰인다. event () 를 재정의할 때 정확히 처리하지 못하는 경 
우를 취급하기 위 하여 기초클라스의 event () 함수를 호출해야 한다. 

③ 하나의 QObject 에 사건 려 과기 를 설 치할수 있 다. 

installEvenffilter () 에 의해 객체를 등록하였다면 목표객체의 모든 사건들은 우선 감시객체 
의 evenffilterO 함수에 송신된다. 이 수법을 리용하여 우의 CustomerlnfoDialog 실례에서 Space 건 
누르기를 처 리하였다. 

④ (^Application 객 체 에 사건 려 과기 를 설 치할수 있 다. 

사건려과기가 qApp (유일한 QApplication 객체)용으로 등록되였다면 응용프로그람안의 매개 
객체 에 대 한 매개 사건은 다른 사건려 과기 에 송신되 기전에 eventFilter (} 함수에 송신된다. 이 
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수법은 오유수정에 사용할수 있다. 또한 QApplication 이 보통 무시하는 금지된 창문부품들에 
송신된 마우스사건들을 처리하는데 쓰일수도 있다. 

⑤ QApplication 의 파생클라스를 만들고 notify () 를 재정의 할수 있다. 

Qt 는 QApplication :: notify () 를 호출하여 사건을 송신한다. 이 함수의 재정의는 사건려과기의 
사건들을 볼 기회를 얻기전에 모든 사건들을 얻는 유일한 방법이다. 일반적으로 여러개의 사 
건려과기들이 동시에 있을수 있으나 notify () 함수는 오직 하나이므로 사건려과기는 더 효과있 
다. 

마우스와 건사건들을 비롯한 많은 사건형들을 전달할수 있다. 사건이 그 목표객체에로 가 
는 도중에 혹은 목표객체자체에 의하여 처리되지 않았다면 전체사건처리과정은 목표객체의 
부모를 새 목표로 하여 반복된다. 이 과정은 사건이 처리되거나 제일 웃준위 객체에 이를 때 
까지 부모들을 따라 올라가면서 계속된다. 



그림 7-2. 대화칸에서 사건전달 

그림 7-2 는 건누르기사건이 대화칸의 자식으로부터 부모에로 전달되여가는 방법을 보여 
준다. 사용자가 건을 누르면 사건은 우선 초점을 가지는 창문부품(이 경우에 오른쪽 아래의 
QCheckBox ) 에로 송신 된 다. QCheckBox 가 사건을 처리 하지 않으면 Qt 는 사건을 QGroupBox 에 
송신하고 끝으로 QDialog 객체에 송신된다. 

제3절. 응답성지연 

QApplication :: execO 를 호출할 때 Qt 의 사건순환고리를 기동한다. Qt 는 기동시에 몇가지 사 
건들을 발생하여 창문부품들을 표시하고 그린다. 그후에 사건순환고리를 실행하고 늘 사건이 
발생하였는가 확인하고 사건들을 응용프로그람의 QObject 들에 발송한다. 

하나의 사건을 처 리하는 도중에 다른 사건들이 생성되 여 Qt 의 사건대기렬에 추가될수 있 
다. 그러면 특정한 사건의 처리에 너무 많은 시간을 소비하고 사용자대면부의 반응이 떠진다. 
례를 들면 응용프로그람이 파일을 디스크에 보관하는 동안에 창문체계에 의하여 생성된 사건 
들은 파일이 보관될 때까지 처리되지 않는다. 보관하는동안 응용프로그람은 창문체계로부터 
자체를 다시 그리려는 요구에 응답하지 않는다. 

하나의 해결책은 여러개의 스레드를 사용하는것이다. 즉 하나는 응용프로그람의 사용자대 
면부용 스레드이고 다른 하나는 과일보관(혹은 시간을 소비하는 다른 조작)을 수행하는 스레 
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드이다. 이렇게 응용프로그람의 사용자대면부는 파일을 보관하는동안 계속 응답성을 유지한 
다. (17 장에서 이것을 달성하는 방법을 알게 된다.) 

더 간단한 해결책은 파일보관코드에서 QApplication :: processEvents (} 를 자주 호출하는것이 
다. 이 함수는 아가 대기하고있는 사건들을 처리하고 조종을 호줄자에게 돌려준다. 사실상 
QApplication :: exec () 는 while 순환보다 processEvents () 함수호출부근에 더 많다. 

여기에 processEventsO 를 리용하여 사용자대면부가 응답성을 지연하는 실례가 있다. 이 실 
례는 Spreadsheet 의 파일보관코드에 기초하고있다. 
bool Spreadsheet : : writeFile(const QString & fileName ) 

{ 

QFile file ( fileName ); 

for (int row = 0; row < NumRows ; ++ row ) { 
for (int col — 0; col < NumCols ; ++ col ) { 

QString str = formula ( row , col ); 
if (! str . isEmpty ()) 

out « ( Q _ UINT 16 )row « ( Q _ UINT 16 )col « str ; 

} 

qApp -> processEvents (); 

} 

return true ; 

} 

이 수법에서 한가지 위험한것은 현재 응용프로그람이 보관중에 있는데 사용자가 기본창 
문을 닫거나 지어는 제 |& ve 를 찰칵하여 정의되지 않은 동작이 발생하는것이다. 이 문제를 
해결하는 가장 간단한 방법은 다음의 호출 
qApp -> processEvents (); 

를 Qt 에게 마우스와 건사건들을 무시하게 하는 다음의 호출로 바꾸는것이다. 

qApp -> eventLoop ()-> processEvents ( QEventLoop : : ExcludeU serlnput ) ; 

흔히 오래동안 실행하는 조작이 발생하였을 때 QProgressDialog 를 표시하려고 한다. 
QProgressDialog 는 응용프로그람에 의 해 이루어 지는 진척상황에 대하여 사용자에게 통지 하는 
진척상황띠를 가지고있 다. 또한 QProgressDialog 는 사용자가 조작을 중지 하게 하는 Cancel 단추 
를 제공한다. 여기에 이 수법으로 Spreadsheet 파일을 보관하는 코드가 있다. 
bool Spreadsheet : : writeFile(const QString & fileName ) 

{ 


QFile file ( fileName ); 




QProgressDialog progress ( tr("Saving file ..."), tr (’’ Cancel ")， NumRows ); 
progress . setModal ( true ); 
for (int row = 0 ;row < NumRows ;++ row ) { 
progress . setProgress ( row ); 
qApp -> processEvents (); 
if ( progress . wasCanceled ()) { 
file . remove (); 
return false ; 

} 

for (int col = 0 ;col < NumCols ;++ col ) { 

QString str = formula ( row , col ); 
if (! str . isEmpty ()) 

out « ( Q _ UINT 16 )row « ( Q _ UINT 16 )col « str ; 

} 

} 

return true ; 

} 

총걸음수가 NumRows 인 QProgressDialog 를 창조한다. 그다음 각 행에 대하여 setProgress () 
를 호출하여 진척상황띠 를 갱신한다. QProgressDialog 는 자동적 으로 현재 진척정 형 값을 총걸음 
수로 나누어 퍼센트를 계산한다. QApplication :: processEventsO 를 호출하여 재그리기사건이나 사 
용자의 찰칵 혹은 건누르기 를 처 리 한다.(례 를 들면 사용자가 Cancel 을 찰칵하게 한다.；) 사용자 
가 Cancel 을 찰칵하면 보관을 중지하고 파일을 삭제한다. 

QProgressDialog 에 대해서는 showO 를 호출하지 않는다. 그것은 진척상황대화칸이 그 일을 
자체로 수행하기때문이다. 보관하려는 파일이 작거나 콤퓨터가 고속이 여서 조작이 짧은 시간 
에 끝난다면 QProgressDialog 는 이것을 탐지하고 그자체를 전혀 표시하지 않는다. 

실행시간이 긴 조작을 처리하는 완전히 다른 수법이 있다. 사용자가 요구할 때 처리를 수 
행하지 않고 응용프로그람이 무부하로 될 때까지 처리를 연기하는것이다. 이것은 응용프로그 
탐이 얼마나 오래동안 무부하상태인가를 예견할수 없으므로 처리를 안전하게 중단하였다가 
되살릴수 있다면 작업이 가능하다. 

Qt 에서 이 수법은 특수한 종류의 시계 즉 Oms 시계를 리용하여 실현할수 있다. 이 시계들 
은 대기하고있는 사건이 없을 때 시간을 요구한다. 여기에 그 처리수법을 보여주는 
timerEventO 실 현의 실례가 있 다. 

void Spreadsheet : : timerEvent(QTimerEvent * event ) 

{ 

if ( event -> timerld () == myTimerld ) { 



while (step < MaxStep && ! qApp -> hasPendingEvents ()) { 
performStep ( step ); 

++ step ; 

} 

} else { 

QTable : : timerEvent ( event ); 

} 

} 

hasPendingEventsO 가 仕 ue 를 돌려주면 처리를 중지하고 조종을 (가에 돌려준다. 처리는 (가가 
대기하고있는 사건들을 모두 처리했을 때 되살아난다. 



제 8 장. 2차원과 3차원도형처리 


이 장에서는 여의 도형처 리능력을 설명한다. 여의 2차원그리기엔진은 QPainter 로서 화면우 
의 창문부품，화면밖의 픽스매프 혹은 인쇄기에 그리는데 사용될수 있다. 또한 Qt 는 도형처리 
를 수행하는 고급한 방법을 제공하는 QCaiwas 클라스를 포함한다. 여기서는 여러가지 형태의 
수천개 항목들을 효과적으로 처 리할수 있는 항목에 기초한 수법을 리용한다. 미 리 정의된 많 
은 항목들이 제공되며 사용자정의캔버스항목들을 쉽게 창조할수 있다. 

QPainter 와 QCanvas 외에 또한 OpenGL 서고를 사용하는 방법이 있 다. OpenGL 은 3차원도형 
을 그리 기 위한 표준서 고이 지 만 2차원도형 그리 기 에 도 사용할수 있다. Qt 응용프로그람에 
OpenGL 코드를 통합하는것은 아주 간단한데 여기서 그것을 보여준다. 


제1절. QPainter 에 의한 그리기 


QPainter 는 창문부품이 나 픽 스매 프와 같은 《그리 기 장치》에 그리 기할 때 사용할수 있 다. 
QPainter 는 자체의 형식을 가지는 사용자정의창문부품들이나 사용자정의항목클라스들을 쓸 때 
효과있다. 또한 QPainter 는 인쇄 에 사용되 는 클라스로서 이 장의 뒤 에서 자세 히 설명 한다. 

QPainter 는 기하학적도형들인 점，선，직4각형, 타원，호, 현, 부채형，다각형，3차베찔곡선을 
그릴수 있다. 또한 적스매프，화상，본문도 그릴수 있다. 

QPainter 구성자에 그리 기장치를 넘길 때 QPainter 는 장치로부터 일부 환경설정을 받아들이 
고 다른 환경설정을 기정값으로 설정한다. 이 설정은 그리기를 수행하는 방법에 영향을 준다. 
3가지 가장 중요한것은 그리기장치의 펜, 솔, 서체 이다. 

• 펜은 직선과 기하학적도형의 테두리를 그리는데 사용된다. 펜은 색갈，두께，선형식，모 
자 ( cap ) 형식，결합형식으로 이루어진다. 
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drawPolylinel) 


drawPolygonO 



drawArcO drawChordO drawPiel) 

그림 8-1. 기하학적도형을 그리는 QPainter 함수들 


NoPen 


DashLine 
DotLine 
DashDotLine 
DashOotDotLine 


그림 8-2. 펜의 형식들 

• 솔은 기하학적도형을 채우는데 사용되는 패턴이다. 솔은 색갈과 형식으로 이루어진다. 

• 서체는 본문을 그리는데 쓰인다. 서체는 계렬과 점크기 등 많은 속성들을 가지고있다. 
이 려 한 설 정 은 QPen , QBrush 혹은 QFont 객 체 에 서 setPen (), setBrush (), seffont () 를 호출하 

변경할수 있다. 











여기에 
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PlatCap SquareCap RoundCap 
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MiterJoin BevelJoin RoundJoin 


그림 8-3. 모자형식과 결합형식들 



CrossPattern BDiaqPattern FDiagPattern OiagCross- HoBrush 


Pattern 


그림 8-4. 솔의 형식들 



기) 타원 니 부재형 [) 베얼곡선 

그림 8-5. 기하학적도형의 실례들 
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QPainter painter ( this ); 

painter . setPen ( QPen ( black , 3, DashDotLine )); 
painter . setBrush ( QBrush ( red , SolidPattem )); 
painter . drawEllipse (20, 20, 100, 60); 

여기에 그림 8-5( 丄)에서 보여준 부채형을 그리는 코드가 있다. 

QPainter painter ( this ); 
painter . setPen ( QPen ( black , 5, SolidLine )); 
painter . setBrush ( QBrush ( red , DiagCrossPattem )); 
painter . drawPie (20, 100, 60, 60 * 16, 270 * 16); 

drawPie () 의 마지막 2 개 인수는 시작각도와 마감각도를 16배한것이다. 

여기에 그림 8-5(미에서 보여준 3차원베쩔곡선을 그리는 코드가 있다. 

QPainter painter ( this ); 

QPointArray points (4); 

points [0] = QPoint (20, 80); 

points[lj = QPoint (50, 20); 

points [2] = QPoint (80, 20); 

points [3] = QPoint (120, 80); 

painter . setPen ( QPen ( black , 3, SolidLine )); 

painter . drawCubicBezier ( points ); 

그리 기장치 의 현재 상태 는 save () 호출에 의해 탄창에 보관되 고 후에 restore () 를 호출할 때 
되살아난다. 이것은 그리기장치의 설정을 일시 변경하였다가 이전값들로 재설정하려고 할 때 
쓸모있다. 

펜，솔, 서체외에 그리기장치를 조종하는 다른 설정은 다음과 같다. 

- 배경 색은 배 경 방식 이 OpaqueMode (기 정 값은 TransparentMode ) 일 때 기 하도형 , 본문 혹은 
비트매프의 배경을 솔패턴으로 채우는데 리용한다. 

• 라스터 조작 (raster operation ) 은 그리 기 장치 에 이 미 표시 되 여 있는 화소들과 새로 그려 지는 
화소들을 결 합하는 방법 을 지 정한다. 기 정값은 CopyROP 로서 새 화소가 이 전 화소값을 무시 
하고 장치 에 단순히 복사된 다는것 을 의 미한다. 다른 라스터 조작으로서 XorROP , NotROP , 
AndROP ， NotAndROP 가 있 다. 

• 솔원점은 솔패턴의 시작점으로서 보통 창문부품의 왼쪽웃구석이다. 

- 잘라내기령역 (clip region ) 은 그리기할수 있는 장치의 구역이다. 잘라내기령역밖에서 수행 
한 그리기조작은 무시된다. 

• 보기 구역，창문, 세계 행 렬 (world matrix ) 은 론리 QPainter 자리 표를 물리 그리 기 장치 자리 표로 
넘기는 방법을 결정한다. 기 정으로 론리와 물리자리표계들은 일치하도록 설정된다. 
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보기구역，창문, 세계행렬에 의하여 정의된 자리표계를 더 구체적으로 고찰하자. (이 상황 
에서 《창문》이라는 용어는 제일 웃준위창문부품의 의미에서 창문을 말하는것이 아니며 또 
《보기 구역》은 QScrollView 의 보기 구역에서 수행 해야 하는 일을 가지고있는것이 아니다.) 

보기구역과 창문은 정확히 한계가 있다. 보기구역 ( viewport ) 은 물리자리표로 지정된 임의 
의 직4각형 이 다. 창문 ( window ) 은 같은 직4각형 을 지 정 하지 만 론리 자리 표로 되 여있다. 그리 기 
할 때 에는 점들을 론리 자리 표로 지 정 하고 이 자리표들은 현재의 창문-보기구역설정 에 기 초하 
는 선형대수적방법에 의하여 물리자리표로 변환된다. 

기정으로 보기구역과 창문은 장치의 직4각형으로 설정된다. 례를 들면 장치가 320 x 200 창 
문부품이면 보기구역과 창문은 꼭같이 왼쪽웃구석의 위치가 (0, 0) 인 320 x 2 W 직4각형이다. 이 
경우에 론리자리표계와 물리자리표계는 같다. 

창문-보기구역기구는 그러기장치의 크기나 분해능에 의존하지 않는 그리기코드를 작성하 
는데 쓸모있다. 우리는 항상 산수적으로 론리자리표를 물리자리표로 넘길수 있지만 QPainter 
가 그렇게 하도록 하는것이 좋다. 례를 들면 중심이 (0, 0) 인 론리자리표를 (-50, -50) 으로부터 
(+50,+50) 까지 전개하려고 한다면 창문을 다음과 같이 설정할수 있다. 
painter . setWindow ( QRect (-50, -50, 100, 100)); 

(-50, -50) 쌍은 원점을 지정하고 (100, 100) 쌍은 폭과 높이를 지정한다. 이것은 론리자리표 
(-50,-50) 이 현재 물리 자리 표 (0,0) 에 대 응되 고 론리 자리 표 (+50,+50) 이 물러 자리 표 (320, 200) 에 
대응된다는것을 의미한다. 이 실례에서 보기구역을 변경할 필요는 없다. 



그러 면 세계행 렬을 고찰하자. 세계 행 렬은 창문-보기 구역변환과 함께 적용되는 변환행 렬 이 
다. 이것은 그리고있는 항목들을 변환하고 신축하고 회전하거나 자르게 한다. 례를 들면 본문 
을 45°각으로 그리 려고 한다면 다음의 코드를 사용할수 있다. 


QWMatrix matrix ; 
matrix . rotate (45.0); 
painter . setWorldMatrix ( matrix ); 
painter . drawText ( rect , AlignCenter , tr ( M Revenue M )); 
drawTextO 에 넘기는 론리자리표들은 세계행렬로 변환된 다음 창문-보기구역설정을 리용 
하여 물리 자리 표로 넘어 간다. 

다중변환을 지정하면 변환들이 주어지는 차례로 적용된다. 례를 들면 회전축점으로서 점 
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(10, 20) 을 리용하려고 한다면 창문을 변환하고 회전하고 창문을 원래 위치로 다시 변환한다. 
QWMatrix matrix ; 
matrix . translate (-1 0.0, -20.0); 
matrix . rotate (45.0); 
matrix . translate (+ 10.0, +20.0); 
painter . setWorldMatrix ( matrix ); 
painter . drawText ( rect , AlignCenter , tr ( n Revenue ")); 

변환을 지 정하는 더 간단한 방법은 QPainter 의 translate (), scale (), rotate (), shear () 편의 함수들 
을 사용하는것이다. 

painter . translate (- 10.0, -20.0); 
painter . rotate (45.0) ; 
painter . translate (+ 10.0, +20.0); 
painter . drawText ( rect , AlignCenter , tr (" Revenue M )); 

그러나 같은 변환을 반복하려고 한다면 변환들을 QWMatrix 객체에 보관하고 변환이 필요 
할 때마다 그리기장치에 세계행렬을 설정하는것이 더 빠르다. 

세계행렬을 보관하였다가 후에 되살리려면 saveWorldMatrixO 와 restoreWorldMatrix () 를 리용 
할수 있다. 

그리 기 장치변환을 설 명 하기 위 하여 그림 8-7 에 보여 주는 OvenTimer 창문부품의 코드를 고 
찰한다. OvenTimer 창문부품은 내부에 시계를 가지고있는 로에서 일반적으로 사용하고있는 물 
리 적 인 로 ( oven ) 시 계 를 모형 화한것 이 다. 사용자는 눈금 ( notch ) 을 찰칵하여 지 속시 간을 설정할 
수 있다. 바퀴는 자동적으로 0에 이를 때까지 시계바늘과 반대방향으로 돌아가며 0점에서 
OvenTimer 는 timeout () 신호를 발생한다. 



class OvenTimer : public QWidget 

{ 

Q_OBJECT 

public : 

OvenTimer(QWidget ^ parent , const char *name = 0); 
void setDuration(int secs ); 
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int duration () const ; 
void draw(QPainter * painter ); 
signals : 

void timeout (); 
protected : 

void paintEvent(QPaintEvent * event ); 
void mousePressEvent(QMouseEvent * event ); 
private : 

QDateTime finishTime ; 

QTimer * updateTimer ; 

QTimer * fmishTimer ; 

}； 

OvenTimer 클라스는 QWidget 를 계승하며 2개의 가상함수 paintEvent () 와 mousePressEvent () 
를 재 정의한다. 

#include < qpainter . h > 

#include < qpixmap . h > 

#include < qtimer . h > 

#include < cmath > 
using namespace std ; 

#include ’’ oventimer . h ” 

const double DegreesPerMinute = 7.0; 

const double DegreesPerSecond = DegreesPerMinute / 60; 

const int MaxMinutes = 45; 

const int MaxSeconds = MaxMinutes * 60; 

const int Updatelnterval =10; 

OvenTimer : : OvenTimer(QWidget * parent , const char * name ) : QWidget ( parent , name ) 

{ 

finishTime = QDateTime : : currentDateTime (); 
updateTimer = new QTimer ( this ); 
finishTimer = new QTimer ( this ); 

connect ( updateTimer , SIGNAL ( timeout ()), this , SLOT ( update ())); 
connect ( finishTimer , SIGNAL ( timeout ()), this , SIGNAL ( timeout ())); 

} 

구성자에서는 2 개의 QTimer 객체를 창조하는데 updateTimer 는 창문부품의 모양을 규칙적 인 
시격으로 갱신하는데 쓰이고 finishTimer 는 시계가 0에 이를 때 창문부품의 timeoutO 신호를 발 
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생 한다. 


void OvenTimer : : setDuration(int secs ) 

{ 

if (secs > MaxSeconds ) 

secs = MaxSeconds ; finishTime = QDateT ime :: currentDateTime (). addSecs ( secs ); 
updateTimer -> start(UpdateInterval * 1000， false ); 
finishTimer -> start(secs * 1000， true ); 
update (); 

} 

setDuration () 함수는 로시계의 지속시간을 주어진 초수로 설정한다. updateTimer 의 start () 호출 
에 넘기는 false 인수는 Qt 에 이것이 10 s 간격으로 시간을 요구하는 반복시계라는것을 말해준다. 
finishTimer 는 한번 시간을 요구하는데 필요하므로 true 인수를 리용하여 그것이 단일발사시계 
라는것을 가리킨다. 초단위의 지속시간을 QDateTime :: currentDateTime () 에 의해 얻어진 현재 시 
간에 더하여 완료시간을 계산하고 finishTime 비공개변수에 보관한다. 

finishTime 변수는 날자와 시간을 보관하는 Qt 자료형인 QDateTime 형이다. QDateTime 의 date 
요소는 현재시간이 자정전이고 완료시간이 자정후인 경우에 중요하다. 
int OvenTimer : : duration () const 
{ 

int secs = QDateTime :: currentDateTime (). secsTo ( finishTime ); 
if (secs < 0) 
secs = 0; 
return secs ; 

} 

duration () 함수는 시계가 완료하기전에 남은 초수를 돌려준다. 
void OvenTimer :: mousePressEvent(QMouseEvent * event ) 

{ 

QPoint point = event -> pos () - rect (). center (); 

double theta = atan 2(-( double ) point . x (), -( double ) point . y ()) * 180 / 3.14159265359; 

setDuration (( int )( duration () + theta / DegreesPerSecond )); 

update (); 

} 

사용자가 창문부품을 찰칵하면 효과적인 수학식을 리용하여 가장 가까운 눈금을 찾아내 
고 결 과를 리 용하여 새 지 속시 간을 설 정한다. 그다음 재 그리 기 를 발생 한다. 사용자가 찰칵한 
눈금은 현재 제일 우에 있으며 0에 이를 때까지 시계바늘방향으로 이동한다. 
void OvenTimer :: paintEvent(QPaintEvent *) 
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{ 


QPainter painter ( this ); 

int side = QMIN ( width (), height ()); 

painter , set Vie wport (( width () - side ) 12 , ( height () - side ) 11 , side , side ); 

painter . setWindow (-50, -50, 100, 100); 

draw (& painter ); 

} 

paintEventO 에서는 보기구역을 창문부품에 알맞는 최대바른4각형구역으로 설정하고 창문 
을 직4각형 (-50,-50, 100, 100) 즉 (-50, -50) 으로부터 (+50, +50) 범 위 의 100 x 100 직4각형 으로 설 정 
한다. QMIN () 마크로는 2개 인 수의 최 소값을 돌려 준다. 



그림 8-8. 3가지 다른 크기 의 OvenTimer 창문부품 
보기구역을 바른4각형으로 설정하지 않았으면 로시계는 창문부품이 바른4각형 이 아닌 직 
4각형 으로 크기 가 달라질 때 타원으로 된다. 일반적으로 그러한 변형 을 피 하려 면 보기 구역 과 
창문을 갈은 가로세로비 를 가지 는 직4각형 들로 설정해 야 한다. 

또한 (-50,-50, 100, 100) 의 창문은 아래와 같은 원인을 고려하여 설정되였다. 

• QPainter 의 draw 함수들은 int 자리표값들을 가진다. 창문을 너무 작게 선택하면 필요한 모 
든 점을 옹근수로 지정할수 없다. 

• 큰 창문을 사용하고 drawTextO 을 리용하여 본문을 그리려면 그것을 보상하는데 더 큰 
서체가 요구된다. 

이것은 말하자면 (-5 -5, 10, 10) 혹은 (-2000, -2000, 4000, 4000) 보다 (-50, -50, 100, 100) 이 더 
좋은 선택으로 되게 한다. 

그러면 그리기코드를 고찰하자. 

void OvenTimer : : draw(QPainter * painter ) 

{ 

static const QCOORD triangle [3][2] ={ 
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{ -2, -49 }，{ +2, -49 }, { 0, -47 } 


}； 

QPen thickPen ( colorGroup (). foreground (), 2); 

QPen thinPen ( colorGroup (). foreground (), 1); 
painter -> setPen ( thinPen ); 
painter -> setBrush ( colorGroup (). foreground ()); 
painter -> drawConvexPolygon ( QPointArray (3, & triangle [0] [0])); 

창문부품의 꼭대기에 0 위치를 표식하는 아주 작은 3각형을 그리는것으로 시작한다. 3각형 
을 3개의 고정자리표들로 지정하고 drawConvexPolygon () 을 리용하여 그린다. drawPolygon () 을 
리용할수 있으나 그리고있는 다각형이 불록하다는것을 알고있을 때 drawConvexPolygonO 을 호 
출하여 조금이나마 시간을 절약할수 있다. 

창문-보기구역기구가 아주 편리한것은 그리기지 령들에서 사용하는 자리표들을 고정 코드 
화하여도 좋은 크기조절동작을 얻을수 있는것이다. 바른4각형이 아닌 창문부품들에 대하여 
걱정하지 않아도 보기구역을 적당히 설정하여 처리한다. 
painter -> setPen ( thickPen ) ; 
painter -> setBrush ( colorGroup (). light ()); 
painter -> drawEllipse (-46, -46, 92, 92); 
painter -> setBrush ( colorGroup (). mid ()); 
painter -> drawEllipse (-20, - 20 , 40, 40); 
painter -> drawEllipse (- 15, -15, 30, 30); 

바깥원과 2 개의 아낙원을 그린다. 바깥원은 조색판의《밝은》요소(일반적으로 백색)로 채 
우고 아낙원들은 〈〈중간》요소(일반적으로 중간재색)로 채운다. 
int secs = duration (); 
painter -> rotate(secs * DegreesPerSecond ); 
painter -> drawRect (-8, -25, 16, 50); 
for (int i = 0 ;i <= MaxMinutes ;++ i ) { 
if (i % 5 == 0) { 

painter -> setPen ( thickPen ); 
painter -> drawLine (0, -41, 0, -44); 

painter -> drawText (- 15, -41, 30, 25, AlignHCenter | AlignTop , QString :: number ( i )); 

} else { 

painter -> setPen ( thinPen ); 
painter -> drawLine (0, -42, 0, -44); 

} 

painter -> rotate (- DegreesPerMinute ); 
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손잡이，눈금 그리고 5번째의 매개 눈금마다 분을 그린다. rotate () 를 호출하여 그리기장치 
의 자리표계를 회전한다. 낡은 자리표계에서 0분표식은 제일우에 있고 현재 0분표식은 나머 
지 시간에 적합한 위치로 이동된다. 직4각형손잡이의 방향이 회전각도에 의존하므로 회전후 
에 손잡이를 그린다. 

for 순환으로 바깥원의 둘레를 따라 눈금표식을 새기고 5분마다 수자들을 새겨넣는다. 본 
문은 눈금표식아래 의 보이 지 않는 직4각형안에 넣 는다. 한번 순환의 끝에 서 그리 기 장치 를 1 
분에 대응하는 량인 7°씩 시계바늘방향으로 회전한다. drawLine () 과 drawText () 호출에 넘기는 
자리표들이 늘 갈다할지라도 다음에 눈금표식을 그릴 때 원둘레의 각이한 위치에 있게 된다. 

로시계를 실현하는 또 하나의 방법은 sin () 과 COS () 를 리용하여 (切 ；) 위치를 자체로 계산하 
여 원둘레에서의 위치들을 찾는것이다. 그러나 그때 여전히 변환과 회전을 리용하여 어떤 각 
도로 본문을 그릴수 있다. 

한가지 문제는 10 s 마다 창문부품전체를 다시 그리기하는데 그때마다 깜빡거림이 발생하 
는것 이 다. 해결 책은 2중완중기능을 추가하는것 이다. 2중완중은 WNoAutoErase 를 기 초클라스구 
성자에 넘기고 처음에 보여준 paintEventO 함수를 다음것과 교체하여 수행할수 있다. 

void OvenTimer :: paintEvent(QPaintEvent * event ) 

{ 

static QPixmap pixmap ; 

QRect rect = event -> rect (); 

QSize newSize = rect . size (). expandedTo ( pixmap . size ()); 

pixmap . resize ( newSize ); 

pixmap . fill ( this , rect . topLefl ()); 

QPainter painter (& pixmap , this ); 

int side = QMIN ( width (), height ()); 

painter . setViewport (( width () - side ) / 2 - event -> rect (). x (), 

( height () - side ) / 2 - event -> rect (). y (), side , side ); 
painter . setWindow (-50, -50, 100, 100); 
draw (& painter ); 

bitBlt ( this , event -> rect (). topLeft (), & pixmap ); 

} 

이번에는 창문부품대신에 픽스매프에 직접 그린다. 픽스매프는 다시 그리려는 구역의 크 
기로 주어지고 창문-보기구역쌍은 창문부품에 직접 수행되는것처럼 그리기가 수행되도록 초 
기화된다. draw () 함수도 역시 변경되지 않는다. 끝으로 bitBlt () 를 리용하여 창문부품에 픽스매 
프를 복사한다. 



이 것은 5장의 4절에서 설명한것과 비 슷하지 만 한가지 중요한 차이 가 있다. 5장에서 
translateO 를 리 용하여 그리 기장치 를 변환하였으나 여 기서는 보기 구역 을 설정할 때 그리 기사건 
의 ^와 ;；자리표들을 던다. 여기서 변환의 리용은 변환이 론리창문자리표로 표시되 여 야 하므로 
편 리 하지 않지 만 사건의 직 4각형 은 물리 자리 표로 되 여 있 다. 

제2절. QCanvas 에 의한 도형처리 

QCanvas 는 QPainter 가 제공하는것보다 도형처 리를 수행하기 위한 더 고급한 대면부를 제 
공한다. QCanvas 는 임의의 형태의 항목들을 포함하며 내적으로 2중완충을 리용하여 깜빡거림 
을 피한다. 자료시각화프로그람들과 2차원유희와 같이 사용자가 조작할수 있는 항목들을 표 
시할 필요가 있는 응용프로그람들에서 QCanvas 의 사용은 QWidget :: paintEventO 나 
QScrollView :: drawContentsO 를 재정의하고 모든것을 수동적으로 다시 그리는것보다 더 좋은 수 
법이다. 

QCanvas 에 보여 준 항목들은 QCanvasItem 이나 그 파생클라스의 실례들이다. (가는 미리 정 
의된 파생클라스들의 모임을 제공한다. 즉 QCanvasLine , QCanvasRectangle , QCanvasPolygon , 
QCanvasPolygonalltem , QCanvasEllipse , QCanvasSpline , QCanvasSprite , QCanvasText 들을 제공한 
다. 이 클라스들은 그 자체가 사용자정의캔버스항목들을 제공하는 파생클라스로 만들수 있다. 

QCanvas 와 그의 QCanvasItem 들은 순수 자료이며 시각적 표시를 가지지 않는다. 캔버스와 
그 항목들을 표시 하려면 QCanvasView 창문부품을 사용해 야 한다. 이와 같이 자료와 그 시각적 
표시의 분리는 같은 캔버스를 시각화하는 여러개의 QCanvasView 창문부품들을 가질수 있게 
한다. 매개의 QCanvasView 는 될수록 각이 한 변환행 렬을 가지 고 캔버 스의 자기 부분을 표시 할 
수 있다. 

QCanvas 는 대 량의 항목들을 처 리 하도록 고도로 최 적 화되 여 있다. 항목이 달라질 때 
QCanvas 는 달라진 부분을 다시 그린 다. 또한 효과적 인 충돌탐색 알고리 듬을 제 공한다. 이 려 한 
리유로 QWidget : : paintEvent () 혹은 QScroirView :: drawContents () 를 재정의하여 QCanvas 를 고찰한 
다. 
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그림 8-9. DiagramView 창문부품 






QCanvas 사용법 을 보여 주기 위 하여 작은 도표편집 기인 DiagramView 창문부품의 코드를 제 
시한다. 창문부품은 2종류의 도형(직4각형칸과 직선)을 유지하며 사용자가 새로운 직4각형과 
직선들을 추가하고 그것들을 복사하고 붙이기하고 삭제하며 그 속성들을 편집하게 하는 상황 
차림표를 제공한다. 

class DiagramView : public QCanvasView 

{ 

Q_OBJECT 

public : 

DiagramView(QCanvas * canvas , QWidget ^parent = 0, const char *name = 0); 
public slots : 
void cut (); 
void copy (); 
void paste (); 
void del (); 
void properties 。; 
void addBox (); 
void addLine (); 
void bringToFront (); 
void sendToBack (); 

DiagramView 클라스는 QCanvasView 를 계승하며 QCanvasView 는 QScrollView 을 계승한다. 
이 클라스는 응용프로그람이 련결할수 있는 많은 공개처리부들을 제공한다. 처리부들은 또한 
창문부품이 자체로 상황차림표를 실현하는데 사용된다. 
protected : 

void contentsContextMenuEvent(QContextMenuEvent * event ); 
void contentsMousePressEvent(QMouseEvent * event ); 
void contentsMouseMoveEvent(QMouseEvent * event ); 
void contentsMouseDoubleClickEvent(QMouseEvent * event ); 
private : 

void createActions (); 
void addItem(QCanvasItem * item ); 
void setActiveItem(QCanvasItem * item ); 
void showNewItem(QCanvasItem * item ); 

QCanvasItem * pendingltem ; 

QCanvasItem * activeltem ; 

QPoint lastPos ; 
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int minZ ; 
int maxZ ; 

QAction * cutAct ; 

QAction * copyAct ; 

QAction * sendToBackAct ; 

}； 

클라스의 보호 및 비공개성원들을 간단히 설명한다. 
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그림 8-10. DiagramBox 와 DiagramLine 캔 버 스항목 
또한 DiagramView 클라스중에서 2개의 사용자정 의 캔버 스항목클라스들을 정 의 하여 그리 려 
고 하는 도형 들을 표시 한다. 이 클라스들의 이 름은 DiagramBox 와 DiagramLine 이 다. 
class DiagramBox : public QCanvasRectangle 
{ 

public : 

enum { RTTI = 1001 }; 

DiagramBox(QCanvas * canvas ); 

~ DiagramBox (); 

void setText(const QString & newText ); 

QString text () const { return str ; } 
void drawShape(QPainter & painter ); 

QRect boundingRect () const ; 
int rtti () const { return RTTI ;} 
private : 

QString str ; 

}； 

DiagramBox 클라스는 직 4 각형과 본문의 부분을 현시하는 캔버스항목의 형이다. 이 클라스 
는 직 4각형을 현시 하는 QCanvasItem 의 파생 클라스 QCanvasRectangle 로부터 그 기능을 계승한 
다. QCanvasRectangle 에 직4각형의 중간에 본문을 표시 하는 능력과 매개 구석 에 아주 작은 바 
른4각형 ( 《손잡이》 ) 을 표시 하고 항목이 능동이라는것을 가리 키는 능력 을 추가한다. 현실세계 
의 응용프로그람에서는 손잡이를 찰칵하고 끌어서 칸의 크기를 조절할수 있게 하지만 여기서 
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는 코드를 간단하게 만든다. 

rttiO 함수는 QCanvasItem 로부터 재정의된다. 함수의 이름은 실행시형식별 ( run-time type 
identification ) 을 의미하며 그 돌림값과 RTTI 상수를 비교함으로써 캔버스안의 임의의 항목이 
DiagramBox 인가 아닌가를 결정 할수 있다. C ++ 의 dynamic _ cast < T >0 기구에 의 하여 같은 검사를 
할수 있으나 그 기능을 유지하는 C ++ 콤파일러들에 제한된다. 

1001값은 임의로취한것이다. W 00 이상의 값을 받아들일수 있다. 이 값은 갈은 응용프로그 
탐에서 사용한 다른 항목형들과 혼돈하지 말아야 한다. 

class DiagramLine : public QCanvasLine 

{ 

public : 

enum { RTTI = 1002 }; 

DiagramLine(QCanvas * canvas ); 

〜 DiagramLine (); 

QPoint oflfset () const { return QPoint (( int ) x (), ( int ) y ()); } 
void drawShape(QPainter & painter ); 

QPointArray areaPoints () const ; 
int rtti () const { return RTTI ; } 

}； 

DiagramLine 클라스는 직선을 표시하는 캔버스항목이다. 이 클라스는 QCanvasLine 로부터 
기능을 계승하며 량끝에 손잡이들을 표시하는 능력을 추가하여 직선이 능동이라는것을 가리 
킨 다. 

이제는 이 3개 클라스의 실현을 고찰한다. 

DiagramView : : DiagramView(QCanvas * canvas , QWidget * parent , const char * name ) 

: QCanvasView ( canvas , parent , name ) 

{ 

pendingltem = 0; 
activeltem = 0; 
minZ = 0; 
maxZ = 0; 
createActions (); 

} 

DiagramView 구성자는 첫 인수로서 canvas 를 가지며 그것을 기초클라스구성자에 넘긴 다. 
DiagramView 는 이 캔버스를 표시한다. 

QAction 들은 createActionsO 비공개함수에서 창조된다. 이미 앞장들에서 이 함수를 실현하 
였으며 여기서도 갈은 형태이므로 다시 생성하지 않는다. 
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void DiagramView: : contentsContextMenuEvent(QContextMenuEvent ^event) 

{ 

QPopupMenu contextMenu(this); 

if (activeltem) { 

cutAct->addTo(&contextMenu); 

copyAct->addTo(&contextMenu); 

deleteAct->addTo(&contextMenu); 

contextMenu.insertSeparator(); 

bringToFrontAct->addTo(&contextMenu); 

sendToBackAct->addTo(&contextMenu); 

contextMenu.insertSeparator(); 

propertiesAct->addTo(&contextMenu); 

} else { 

pasteAct->addTo(&contextMenu); 
contextMenu.insertSeparator(); 
addBoxAct->addTo(&contextMenu); 
addLine Act- 〉 addTo(&contextMenu); 

} 

contextMenu.exec(event->globalPos()); 

} 

contentsContextMenuEvent() 함수는 QScrollView 로부터 재정의되여 상황차림표를 창조한다 . 

日色 Paste 

[3 때切 M 

/ 쎄대 

그림 8-ll.DiagramView 창문부품의 상황차림표들 
항목이 능동이면 차림표는 항목에서 의미를 가지는 작용들 즉 Cut, Copy, Delete, Bring to 
Front, Send to Back, Properties 들로 채워진다 . 그렇지 않으면 차림표는 Paste, Add Box, Add L 
ine. 로 채워진다 . 

void DiagramView: : addBoxO 
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addltem(new DiagramBox(canvas())); 


} 

void DiagramView :: addLine() 

{ 

addltem(new DiagramLine(canvas())); 

} 

addBox() 와 addLine() 처리부들은 캔버스에 대하여 DiagramBox 이나 DiagramLine 항목을 창조 
한 다음 addltemO 를 호줄하여 나머지 작업을 수행한다 . 
void DiagramView :: addItem(QCanvasItem *item) 

{ 

delete pendingltem; 
pendingltem = item; 
setActiveltem(O); 
setCursor(crossCursor); 

} 

addltemO 비공개함수는 유표를 + 유표로 바꾸고 pendingltem 을 새로 창조된 항목으로 설정 
한다 . 항목은 show() 를 호출하기전 에는 캔버 스에서 보이 지 않는다 . 

사용자가 상황차림 표로부터 Add Box 나 Add Line 을 선 택 하면 유표는 +유표로 달라진 다 . 항 
목은 사용자가 캔버스우에서 찰칵할 때까지 실제로 추가되지 않는다 . 
void DiagramView::contentsMousePressEvent(QMouseEvent *event) 

{ 

if (event->button() = LeftButton && pendingltem) { 
pendingItem->move(event->pos().x() 5 event- 〉 pos().y()); 
showNewItem(pendingItem); 
pendingltem ■ 0; 
unsetCursor(); 

} else { 

QCanvasItemList items = canvas()->collisions(event->pos()); 
if (items.emptyO) 
setActiveltem(O); 

else 

setActiveItem(*items.begin()); 

} 

lastPos = event->pos(); 



유표가 +일 때 사용자가 왼쪽마우스단추를 찰칵하면 직 4 각형이나 직선을 창조할것을 요 
구하며 새 항목을 표시하려는 위치에서 캔버스를 찰칵한다 . 항목을 찰칵한 위치에 직 4 각형이 
나 선분을 새로 표시 하고 유표를 표준화살유표로 재설정한다 . 

캔버스에 대한 다른 마우스누르기사건은 항목을 선택하거나 선택을 해제하려는 시도로 
해석된다 . 캔버스에 대하여 collisions() 를 호출하여 유표아래의 모든 항목들을 얻고 첫 항목을 
현재 항목으로 만든다 . 목록이 많은 항목을 포함하면 첫 항목은 항상 다른 항목들의 꼭대기 
에 그려지는 항목이다 . 

void DiagramView: : contentsMouseMoveEvent(QMouseEvent *event) 

{ 

if (event->state() & LeftButton) { 
if (activeltem) { 

activeItem->moveBy(event->pos().x() - lastPos.xQ, event->pos().y() - lastPos.yQ); 



canvas()->update(); 


} 

} 

사용자는 항목우에서 왼쪽마우스단추를 누르고 끌기하여 항목을 캔버스우에서 옮길수 있 
다 . 마우스이동사건을 얻을 때마다 마우스가 이동한 수평 및 수직거리만큼 항목을 옮기고 캔 
버 스에 대하여 updateO 를 호출한다 . 캔버 스항목을 수정할 때마다 update 。 를 호출하여 캔버 스 
에 그 자체 를 다시 그려야 한다는것 을 통지한다 . 

void DiagramView: : contentsMouseDoubleClickEvent(QMouseEvent *event) 

{ 

if (event->button() = LeftButton && activeltem && 

activeltem->rtti() == DiagramBox: : RTTI) { 

DiagramBox *box = (DiagramBox *)activeltem; 
bool ok; 

QString newText = QInputDialog::getText(tr(’’Diagram"), tr("Enter new text:"), 

QLineEdit: : Normal, box->text(), &ok, this); 

if (ok) { 

box->setText(newText); 
canvas()->update(); 

} 

} 
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} 

사용자가 항목을 두번 찰칵하면 항목의 rttiO 함수를 호출하고 그 돌림값을 

DiagramBox :: RTTI(10 이로 정의된다)와 비교한다. 



그림 8-12. DiagramBox 항목의 본문변경 


항목이 DiagramBox 이면 QInputDialog 를 펼치고 사용자가 칸에 표시되는 본문을 변경하게 
한다. QInputDialog 클라스는 표식 자，행 편 집 기，단추， Ca«ce/ 단추를 각각 하나씩 제 공한다. 
void DiagramView: :bringToFront() 

{ 



-H-maxZ; 

activeItem->setZ(maxZ); 
canvas()->update(); 

} 

} 

bringToFrontO 처리 부는 캔버스에서 현재 능동인 항목이 다른 항목들의 꼭대기에 놓이게 
한다. 이것은 그 항목의 z 자리표를 다른 항목들에 설정된 값보다 더 큰 값으로 설정함으로써 
달성한다. 2개 항목이 갈은 ( xjO 위치를 차지할 때 제일 큰 z 값을 가지는 항목을 제일 앞에 표 
시 한다. 仁값이 갈으면 QCanvas 는 항목지 적 자들의 값에 따라 겹 쳐 놓는다.；) 
void DiagramView :: sendToBack() 

{ 



—minZ; 

activeItem->setZ(minZ) ; 
canvas ()->update(); 

} 

} 

sendToBackO 처리부는 캔버스에서 현재 능동인 항목을 다른 모든 항목들의 뒤에 넣는다. 
이것은 그 항목의 z 자리표를 다른 항목들의 z 값보다 작은 값으로 설정하여 수행한다. 
void DiagramView: :cut() 
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{ 

copy (); 

del(); 

} 

cut() 처리부는 보통과 갈다. 

void DiagramView::copy() 

{ 

if (activeltem) { 

QString str; 

if (activeltem->rtti() == DiagramBox::RTTI) { 

DiagramBox *box = (DiagramBox *) activeltem; 
str = QStringC'DiagramBox %1 %2 %3 %4 %5 M ) 

.arg(box->width()) 

.arg(box->height()) 

.arg(box->pen().color().name()) 

.arg(box->brush().color().name()) 

.arg(box- 〉 text()); 

} else if (activeltem->rtti() == DiagramLine: : RTTI) { 

DiagramLine * line = (DiagramLine *)activeltem; 

QPoint delta = line->endPoint() -line->startPoint(); 
str = QString("DiagramLine %1 %2 %3") 

.arg(delta.x()) 

.arg(delta.y()) 

.arg(line->pen().color().name()); 

} 

Q Application: : clipboard()->setText(str); 

} 

} 

copyO 처리부는 능동항목을 문자렬로 변환하고 문자렬을 오려둠판에 복사한다. 

문자렬은 항목을 재구성하는데 필요한 모든 정보를 포함한다. 례를 들면 ’’My Left Foot” 를 
포함하는 훅백색의 320x40 칸은 다음의 문자멸로 표시된다. 

DiagramBox 320 40 #000000 #ffffffMy Left Foot 

캔버스상의 항목위치를 기억할 필요는 없다. 그 항목을 덧붙일 때 놓으러는 위치에서 마 
우스찰칵하면 되기때문이 다. 객체를 문자렬로 변환하는것은 오려둠판기능을 추가하는 방법 이 
다. 
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void DiagramView: : paste() 

{ 

QString str = QApplication::clipboard()->text(); 
QTextIStream in(&str); 

QString tag; 
in » tag; 

if (tag = ’’DiagramBox") { 
int width; 
int height; 

QString lineColor; 

QString fillColor; 

QString text; 

in » width » height » lineColor »fillColor; 
text = in.read(); 

DiagramBox *box = new DiagramBox(canvas()); 
box->move(20, 20); 
box->setSize(width, height); 
box->setText(text); 
box->setPen(QColor(lineColor)); 
box->setBrush(QColor(fillColor)); 
showNewItem(box); 

} else if (tag == "DiagramLine") { 
int deltaX; 
int deltaY; 

QString lineColor; 

in » deltaX » deltaY » lineColor; 
DiagramLine *line = new DiagramLine(canvas()); 
line->move(20, 20); 
line->setPoints(0, 0, deltaX, deltaY); 
line->setPen(QColor(lineColor)); 
showNewItem(line); 



paste () 처리부는 QTextIStream 을 리용하여 오려둠판의 내용을 해석한다 . QTextIStream 은 cin 
과 비 숫한 방법 으로 공백 으로 구분한 마당들과 작업한다 . >〉연산자를 리 용하여 매개 마당을 




는데 DiagramBox 항목의 마지막 마당은 공백을 포함할수 있으므로 발취하지 않는디 
서 는 QTextStream: : read() 를 리 용하여 나머 지 문자 렬 에 읽 어 들 인 다 . 
d DiagramView::del() 

if (activeltem) { 

QCanvasItem *item = activeltem; 
setActiveItem(0); 
delete item; 
canvas()->update(); 

} 

0 처리부는 능동항목을 삭제하고 QCanvas::update() 를 호출하여 캔버스를 다시 그린도 
d DiagramView: : properties() 


if (activeltem) { 

PropertiesDialog dialog; 
dialog.exec(activeltem); 

} 

} 

propertiesO 처리 부는 능동항목에 대하여 Properties 대화칸을 펼친다 . PropertiesDialog 클라스 
느급한》대화칸이며 단순히 대화칸에 능동항목의 지적자를 넘기면 된다 . 



그림 8-13. Properties 대화칸의 두 형태 





void DiagramView :: showNewItem(QCanvasItem *item) 

{ 

setActiveltem(item); 

bringToFront(); 

item->show(); 

canvas()->update(); 

} 

showNewItemQ 비공개 함수는 코드안의 여러 곳에서 호출되며 새로 창조한 캔버스항목을 표 
시하고 능동으로 한다 . 

void DiagramView: : setActiveItem(QCanvasItem *item) 

{ 

if (item != activeltem) { 
if (activeltem) 

activeItem->setActive(false); 
activeltem = item; 
if (activeltem) 

activeItem->setActive(true); 
canvas()->update(); 

} 

} 

끝으로 setActiveItem() 비공개 함수는 낡은 능동항목의 《능동》기발을 지우고 activeltem 변수 
를 설 정 하며 새 능동항목의 기 발을 설 정 한다 . 항목의 《능동》기 발은 QCanvasItem 에 보관된다 . 
어는 기발자체를 사용하지 않는다 . 기발은 순수 파생클라스들의 편리를 위하여 제공된다 . 
DiagramBox 와 DiagramLine 파생 클라스들이 능동인가 아닌가에 따라서 각이 하게 그것들을 그리 
려고 하므로 그 파생클라스들에서 기발을 리용한다 . 

그러 면 DiagramBox 와 DiagramLine 의 코드를 고찰하자 . 
const int Margin = 2; 

void drawActiveHandle(QPainter &painter, const QPoint &center) 

{ 

painter.setPen(Qt: : black); 
painter.setBrush(Qt: : gray); 

painter.drawRect(center.x() - Margin, center.y() - Margin, 2 * Margin + 1, 

2 * Margin + 1); 

} 

drawActiveHandleQ 함수를 2 개의 DiagramBox 와 DiagramLine 에서 사용하며 항목이 능동항목 



이 라는것 을 가리키 는 아주 작은 바른 4 각형 을 그린 다 . 


DiagramBox: : DiagramBox(QCanvas * canvas) : QCanvasRectangle (canvas) 

{ 

setSize(100, 60); 
setPen(black); 
setBrush(white); 
s 仕 = "Text"; 

} 

DiagramBox 구성자에서는 직 4 각형의 크기를 100><60 으로 설정 한다 . 또한 펜색을 흑색으로， 
솔색 을 백 색 으로 설정한다 . 펜색 은 4 각형 의 테 두리 와 본문을 그리 는데 쓰이 고 솔색 은 4 각형 
의 배경을 칠하는데 쓰인다 . 

DiagramBox: :~DiagramBox() 

{ 

hide(); 

} 

DiagramBox 해체자는 항목에 대하여 hide() 를 호출한다 . 이것은 QCanvasPolygonalltem 이 작 
업하는 방식으로 인하여 QCanvasPolygonlItem(QCanvasRectangle 의 기초클라스)로부터 계승되는 
모든 클라스들에 필요하다 . 

void DiagramBox::setText(const QString &newText) 

{ 

str = newText; 
update(); 

} 

setText() 함수는 직 4 각형 안에 표시 할 본문을 설 정 하고 QCanvasItem::update() 를 호출하여 이 
항목을 변경된것으로 표식한다 . 

void DiagramBox: : drawShape(QPainter &painter) 

{ 

QCanvasRectangle :: drawShape(painter) ; 
painter.drawText(rect(), AlignCenter, text()); 
if (isActive()) { 

drawActiveHandle(painter, rect().topLefl()); 
drawActiveHandle(painter, rect().topRight()); 
drawActiveHandle(painter, rect().bottomLeft()); 
drawActiveHandle(painter, rect().bottomRight()); 




drawShape() 함수는 본문항목이 능동인 경우에는 4 개의 손잡이를 그리도록 

QCanvasPolygonalltem 로부터 재정의된다 . 기초클라스를 리용하여 직 4 각형 자체를 그린다 . 

QRect DiagramBox: : boundingRect() const 

{ 

return QRect((int)x() - Margin, (int)y() - Margin, width() + 2 * Margin, 
height() + 2 * Margin); 

} 

boundingRectO 함수는 QCanvasItem 으로부터 재정의된다 . QCanvas 에서는 이 함수를 충돌람 
색과 그리기최적화에 리용한다 . 함수가 돌려주는 직 4 각형은 적어도 drawShape() 에서 그리는 
령역만큼 커야 한다 . 

QCanvasRectangle 의 기정실현은 충분하지 못하다 . 왜냐하면 항목이 능동으로 되면 직 4 각 
형의 각 모서리에 그리는 손잡이들을 고려하지 않았기때문이다 . 

DiagramLine :: DiagramLine(QCanvas *canvas) : QCanvasLine(canvas) 

{ 

setPoints(0, 0, 0, 99); 

} 

DiagramLine 구성 자에 서 는 선 분을 정 의 하는 두점 을 (0, 0) 과 (0, 99) 로 설 정한다 . 결 과는 100 
화소길이의 수직선이다 . 

DiagramLine: :~DiagramLine() 

hide(); 

} 

다시 해체자에서 hideO 를 호출해야 한다 . 
void DiagramLine::drawShape(QPainter &painter) 

{ 

QCanvasLine :: drawShape(painter); 
if (isActive()) { 

drawActiveHandle(painter, startPoint() + offset()); 
drawActiveHandle(painter, endPoint() + offset()); 

} 

} 

항목이 능동이면 직선의 량끝에 손잡이를 그리도록 QCanvasLine 으로부터 drawShape() 함수 
를 재 정의한다 . 기 초클라스를 리 용하여 직 선자체를 그린다 . offset() 함수는 DiagramLine 클라스정 
의에서 실현된다 . 이 함수는 캔버스에서 항목의 위치를 돌려준다 . 



QPointArray DiagramLine: : areaPoints() const 

{ 

const int Extra = Margin + 1; 

QPointArray points(6); 

QPoint pointA = startPoint() + offset(); 

QPoint pointB = endPoint() + ofFset(); 
if (pointA.x() > pointB.x()) 
swap(pointA, pointB); 

points[0] = pointA + QPoint(-Extra, -Extra); 
points[l] = pointA + QPoint(-Extra, +Extra); 
points[3] = pointB + QPoint(+Extra, +Extra); 
points[4] = pointB + QPoint(+Extra, -Extra); 
if (pointA.y() > pointB.y()) { 

points[2] = pointA + QPoint(+Extra, +Extra); 
points[5] = pointB + QPoint(-Extra, -Extra); 

} else { 

points[2] = pointB + QPoint(-Extra, +Extra); 
points[5] = pointA + QPoint(+Extra, -Extra); 

} 

return points; 

} 

areaPoints() 함수는 DiagramBox 에서 boundingRect() 함수와 비숫한 역할을 한다 . 

경계직 4 각형은 대각선과 실제로 대부분의 다각형들에서 거의 비슷하다 . 이것들에 대하여 
areaPointsO 를 재정의하고 항목이 그려지는 구역의 테두리를 돌려준다 . QCanvasLine 실현은 이 
미 직선의 아주 좋은 륜곽선을 돌려주지만 손잡이들을 고려하지 않는다 . 

처음으로 할 일은 두점을 pointA 와 pointB 에 보관하고 pointA 가 pointB 의 왼쪽에 놓이도록 
한다 . (필 요하다면 swapO(<algorithm> 에 서 정 의 ) 로 두 점 을 서 로 교체 한다 ). 그때 고려 해 야 할 
두가지 경우가 있다 . 즉 올리경사선과 내리경사선인 경우이다 . 

직선의 경계구역은 늘 6 개의 점들로 표시되지만 이 점들은 직선이 내리경사인가 올리경 
사인가에 따라 달라진다 . 그럼에도 불구하고 6 점중 4 개(번호 0,1,3, 4) 는 두 경우에 같다 . 례를 
들면 점 0 과 1 은 늘 손잡이 A 의 왼쪽웃구석과 왼쪽아래구석에 배치되지만 이와 대조적으로 
점 2 는 올리 경 사선인 경 우에는 손잡이 A 의 오른쪽아래구석 에 배치 되 고 내 리 경사선 인 경 우에 
는 손잡이 B 의 왼쪽아래구석에 배치된다 . 






1 


0 


回 


그림 8-14. DiagramLine 의 경 계 구역 

작성 한 얼마 안되는 코드를 고려 하면 DiagramView 창문부품은 이미 상당한 기능을 제공하 
며 항목들의 선택 및 이동과 상황차림표를 가지고있다 . 

놓친것은 항목이 능동일 때 표시된 손잡이들을 항목의 크기를 변경하기 위하여 끌기할수 
없는것이다 . 그것을 변경하려고 한다면 여기서 사용한것과는 다른 수법을 리용해야 한다 . 항 
목의 drawShapeG 함수들에서 손잡이를 그리지 않고 매개 손잡이를 캔버스항목으로 만든다 . 손 
잡이우로 이동할 때 유표를 변경하려고 한다면 실제로 이동되는 시각에 setCursor() 를 호출할 
수 있다 . 그러자면 마우스단추를 찰칵할 때 Qt 는 보통 마우스이동사건들만 송신하므로 우선 
setMouseTracking(ttue) 를 호출해야 한다 . 

또한 다중선택과 항목그룹화를 유지하도록 개량할수 있다 . 

이 절에서는 QCanvas 와 QCanvasView 사용의 동작실례를 제공하였으나 QCanvas 의 기능을 
모두 설명하지는 않았다 . 례를 들면 캔버스항목들은 setVelocityO 를 호출하여 규칙적인 시격으 
로 캔 버 스우를 이 동함으로써 설 정할수 있다.(자세 한 내 용은 QCanvas 와 그 관련 클라스들의 문 
서를 보시오 .) 


제3절. 인쇄 

뱐에서 인쇄는 창문부품이나 픽스매프상에서 그리기와 비숫하다 . 인쇄는 다음의 단계들로 
이루어진다 . 

① 그리 기장치 로서 작업 하는 QPrinter 를 창조한다 . 

② QPrinter::setup() 를 호출하여 인쇄대화칸을 열고 사용자가 인쇄기를 선택하고 몇가지 
항목을 설정하게 한다 . 

③ QPrinter 에 조작하는 QPainter 를 창조한다 . 

④ QPainter 에 의해 폐지 를 그린다 . 

⑤ QPrinter::newPage () 를 호출하여 다음 폐지로 넘어 간다 . 

⑥ 걸음 ④와 ⑤를 모든 폐지를 인쇄할 때까지 반복한다 . 

Windows 와 Mac OS 표에서 QPrinter 는 체계의 인쇄기구동프로그람을 리용한다 . Unix 에서 QP 
rinter 는 PostScript 를 생성하고 그것을 lp 혹은 lpr(QPrinter :: setPrintProgram() 에 의해 설정된 프로 
그람)에로 송신한다 . 
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그림 8-15. OverTimer, QCanvas, Qlmager 의 인 쇄 

한 폐지우에 모두 인쇄하는 간단한 실례부터 보기로 하자 . 첫 실례는 OvenTimer 창문부품 
을 인쇄한다 . 

void PrintWindow::printOvenTimer(OvenTimer *ovenTimer) 

{ 

if (printer, setup ( 仕 iis)) { 

QPainter painter(&printer); 

QRect rect = painter.viewport(); 

int side = QMIN(rect.width(), rect.height()); 

painter.setViewport(0, 0, side, side); 

painter.setWindow(-50, -50, 100, 100); 

ovenTimer->draw(&painter); 

} 

} 

PrintWindow 클라스가 QPrinter 형의 printer 라는 성원 변수를 가진다고 가정 한다 . 간단히 
printOvenTimer() 에서 탄창에 QPrinter 를 창조할수 있으나 한 인쇄에서 다른 인쇄에로 사용자의 
설정을 넘길수 없다 . 

se tup() 를 호출하여 인쇄대화칸을 펼친다 . 대화칸은 사용자가 OK 단추를 찰칵하면 true 를 
돌려주고 그렇지 않으면 false 를 돌려준다 . s 的 ip() 호출후에 QPrinter 객체는 사용준비가 되여있 
다 . 

QPainter 를 창조하여 QPrinter 에 그리 기 한다 . 그다음 painter 의 보기 구역 바른 4 각형 을 만들고 
painter 의 창문을 OvenTimer 가 요구하는 직 4 각형 인 (-50, -50, 100, 100) 으로 초기 화한다 . draw() 를 
호출하여 그리기를 수행한다 . 보기구역바른 4 각형을 설정하지 않으면 OvenTimer 는 폐지의 전 
체 높이 만큼 수직 으로 늘어난다 . 

기정으로 QPainter 의 창문은 printer 가 화면과 비숫한 분해능(보통 72 〜 100dpi) 을 가지도록 
초기화되고 이것은 인쇄에서 창문부품그리기코드를 간단히 재리용하게 한다 . 여기서는 자체 




의 창문을 (-50,-50, 100, 100 ) 으로 설정 하였으므로 문제가 없다 . 

OvenTimer 인쇄는 창문부품이 화면상에서 사용자와의 교제를 위하여 예정된것이므로 그리 
현실적인 실례가 못된다 . 그러나 5 장에서 개발한 Plotter 창문부품과 갈은 다른 창문부품들에 
서는 창문부품의 그리기코드를 인쇄에 재리용하는것이 큰 의의가 있다 . 

더 실천적인 실례는 QCanvas 인쇄이다 . 캔버스를 사용하는 응용프로그람들은 흔히 사용자 
가 그린것을 인쇄할수 있어야 한다 . 이것은 다음과 같이 일반적인 방법으로 수행할수 있다 . 


void PrintWindow: : printCanvas(QCanvas *canvas) 

{ 

if (printer, setup(this)) { 

QPainter painter(&printer); 

QRect rect = painter.viewport(); 

QSize size = canvas->size(); 

size.scale(rect.size(), QSize: :ScaleMin); 

painter.setViewport(rect.x(), rect.y(), size.width(), size.height()); 
painter.setWindow(canvas->rect()); 
painter.drawRect(painter.window()); 
painter. setClipRect(painter.viewport()); 

QCanvasItemList items = canvas->collisions(canvas->rect()); 
QCanvasItemList::const iterator it = items.end(); 
while (it != items.begin()) { 

-it ； 

(*it)->draw(painter); 



이번에는 painter 의 창문을 캔버스의 경계직 4 각형으로 설정하고 같은 가로세로비를 가지는 
직 4 각형으로 보기구역을 제한한다 . 이것을 달성하려면 둘째인수로서 ScaleMin 를 가지는 
QSize::scale () 를 사용한다 . 례를 들면 캔버스가 640x480 크기를 가지고 painter 의 보기구역크기 
가 5000x5000 이면 우리가 사용하는 결과의 보기구역크기는 5000x3750 이다 . 

인수로서 캔버스의 직 4 각형을 넘기여 collisions () 를 호출하여 제일 큰것부터 제일 작은 z 
값에 따라 정렬된 볼수 있는 모든 캔버스항목들의 목록을 얻는다 . 보다 큰 z 값을 가지는 항목 
들보다 먼저 보다 작은 z 값을 가지는 항목들을 그리기 위하여 목록을 끝으로부터 순환하면서 
그것들에 대하여 QCanvasItem::draw () 를 호출한다 . 이것은 앞에 있는 항목들이 뒤에 있는 항목 
들의 꼭대기에 그려진다는것을 담보한다 . 

셋째 실례는 Qlmage 를 그리는것이다 . 



void PrintWindow: : printImage(const Qlmage &image) 

{ 

if (printer, setup(this)) { 

QPainter painter(&printer); 

QRect rect = painter.viewport(); 

QSize size = image.size(); 
size.scale(rect.size(), QSize: :ScaleMin); 

painter.setViewport(rect.x(), rect.y(),size.width(), size.height()); 

painter.setWindow(image.rect()); 

painter.drawlmage(0, 0, image); 

} 

} 

창문을 화상의 직 4 각형으로 설정하고 보기구역을 갈은 가로세로비를 가지는 직 4 각형으로 
설정하고 위치 (0,0 ) 에 화상을 그린다 . 

한폐지밖에 안되 는 항목들의 인쇄는 간단하다 . 그러 나 많은 응용프로그람들은 여 러 폐지 
에 인쇄해야 한다 . 그러한 경우에 한번에 1 폐지를 그리고 newPage () 를 호출하여 다음 폐지로 
넘어가야 한다 . 이것은 각 폐지에 인쇄할수 있는 정보가 얼마인가를 결정하는 문제를 제기한 
다 . 

Qt 에서 여러폐지문서를 처리하는 두가지 방법이 있다 . 

. 요구하는 자료를 HTML 로 변환하고 Qt 의 리치본문엔진 QSimpleRichText 를 사용하여 그 
것 을 표시 한다 . 

• 손에 의한 그리 기 와 폐 지 분할을 수행 한다 . 

두가지 수법 을 차례 로 고찰하자 . 

실례로 본문으로 서술한 꽃이름들의 목록인 꽃편람을 인쇄하려고 한다 . 편람에서 매개 항 
목은 《이름 : 설명》형식의 문자렬로 보관된다 . 례를 들면 
Miltonopsis santanae: 가장 위 험 한 란초과 . 

매 개 꽃의 자료가 단일문자렬로 표시 되 므로 하나의 QStringList 에 의해 편람안의 꽃들을 
모두 표시할수 있다 . 

여기 에 Qt 의 리치본문엔진에 의해 꽃편람을 인쇄하는 함수가 있다 . 
void PrintWindow::printFlowerGuide(const QStringList &entries) 

{ 

QString str; 

QStringList::const 一 iterator it = entries.begin(); 
while (it != entries.end()) { 

QStringList fields = QStringList::split( M : ", *it); 
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그림 8-16. QSimpleRichText 에 의 한 꽃편 람의 인 쇄 
첫 단계는 자료를 HTML 로 변환하는것이다 . 매개 꽃은 2 개 세포를 가지는 HTML 표로 된 
다 . QStyleSheet::escape () 에 의하여 특수문자 &，<，>를 대응하는 HTML 항목들 (”&amp ; ”， 

"&gt ;") 로 교체한다 . 그다음 printRichText () 를 호출하여 본문을 인쇄한다 . 
const int LargeGap = 48; 

void PrintWindow: : printRichText(const Q String &str) 

{ 

if (printer, setup(this)) { 

QPainter painter(&printer); 

int pageHeight = painter.window().height() -2 * LargeGap; 

QSimpleRichText richText(str, bodyFont, 0, 0, pageHeight); 
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richText.setWidth(&painter, painter.window().width()); 

int numPages = (int)ceil((double)richText.height() / pageHeight); 

int index; 

for (int i = 0; i < (int)printer.numCopies(); ++i) { 
for (int j = 0; j < numPages; ++j) { 
if (i > 0 || j > 0) 
printer.newPage(); 

if (printer.pageOrder() == QPrinter: : LastPageFirst) 

{ 

index = numPages -j -1; 

} else { 

index = j; 

} 

printPage(&painter, richText, pageHeight, index); 

} 

} 

} 

} 

printRichTextO 함수는 HTML 문서의 인쇄 를 고려 한다 . 이 함수는 임의 의 Qt 응용프로그람에 
서 임의의 HTML 을 인쇄하는데 리용할수 있다 . 

창문크기와 머리부 (header) 와 꼬리부 (footer) 용으로 폐지의 꼭대기와 밑에 남기려는 짱의 
크기를 고려하여 1 폐지의 높이를 계산한다 . 그다음 HTML 자료를 포함하는 QSimpleRichText 객 
체를 창조한다 . QSimpleRidiText 구성자의 마지막 인수는 폐지 높이 이고 QSimpleRichText 는 그것 
을 사용하여 마음에 드는 폐지가르기를 생성한다 . 



그림 8-17. 꽃편람의 폐지배치 











그다음 각 폐지를 인쇄한다 . 사용자가 요구한 사본수를 생성하기 위하여 필요한 회수만큼 
바깥쪽 for 순환을 반복한다 . 대부분의 인쇄기구동프로그람들은 여러 사본을 유지하므로 이것 
들에 대하여 QPrinter::numCopiesO 는 늘 1 을 돌려준다 . 인쇄기구동프로그람이 여러 사본을 유 
지하지 않으면 numCopiesQ 는 사용자가 요구하는 사본수를 돌려주며 응용프로그람은 그 량만 
큼 인쇄하는데 응답할수 있다 . 앞의 실례들에서는 단순성을 위하여 numCopiesO 를 무시하였 
다 . 

안쪽 for 순환은 폐지들을 순환한다 . 첫 폐지가 아니면 newPage() 를 호출하여 낡은 폐지를 
지 우고 새 폐 지 에 대 한 그리 기 를 시 작한다 . printPage() 를 호출하여 매 개 폐 지 를 그린다 . 

인쇄대화칸은 사용자가 반대순서로 폐지들을 인쇄하게 한다 . 

printer, bodyFont, footerFont 가 PrintWindow 클라스의 성 원변 수라고 가정 한다 . 

void PrintWindow: : printPage(QPainter *painter, const QSimpleRichText &richText, 
int pageHeight, int index) 

{ 

QRect rect(0, index * pageHeight + LargeGap, richText.width(), pageHeight); 
painter->saveWorldMatrix(); 
painter->translate(0, -rect.y()); 

richText.draw(painter, 0, LargeGap, rect, colorGroupO); 

painter->restoreWorldMatrix(); 

painter->setFont(footerFont); 

painter->drawText(painter->window(), AlignHCenter | AlignBottom, 

QString::number(index + 1 ))； 

} 

printPage() 함수는 문서의 (index+1) 번째 폐지를 인쇄한다 . 폐지는 HTML 과 꼬리부구역안의 
폐 지번호로 이 루어 진다 . 

QPainter 를 해석하고 위치와 그리려는 리 치본문의 몫을 지정하는 직 4 각형을 인수로 하여 
draw() 를 호출한다 . 이것은 높이가 pageHeight 인 작은 부분들로 갈라야 하는 아주 긴 하나의 
폐지로서 리치본문을 보여주도록 한다 . 

그다음 폐지바닥의 중심 에 폐지번호를 그린다 . 매 페지 우에 머 리부를 주려 면 여 분의 
drawText() 호출을 사용해 야 한다 . 

LargeGap 상수는 48 로 설정된다 . 96dpi 의 화면분해능을 가정하면 이것은 0.5in(12.7mm) 이다 . 
화면분해능에 관계없이 정확한 길이를 엄으려면 다음과 같이 QPaintDeviceMetrics 클라스를 사 
용해야 한다 . 

QPaintDeviceMetrics metrics(&printer); 
int LargeGap = me 仕 ics.logicalDpiY() / 2; 

여기에 PrintWindow 구성자에서 bodyFont 와 footerFont 를 초기화하는 방법이 있다 . 




bodyFont = QFont("Helvetica", 14); 
footerFont = bodyFont; 

그러면 QPainter 에 의해 꽃편람을 그리는 방법을 보기로 하자 . 여기에 새로운 

printFlowerGuide() 함수가 있다 . 

void PrintWindow: : printFlowerGuide(const QStringList &entries) 

{ 

if (printer, setup(this)) { 

QPainter painter(&printer); 
vector<QStringList> pages; 
int index; 

paginate(&painter, &pages, entries); 
for (int i = 0; i < (int)printer.numCopies(); ++i) { 
for (int j = 0;j < (int)pages. size() ;++j) { 
if (i 〉 0 || j > 0) 
printer.newPage(); 

if (printer.pageOrder() == QPrinter: : LastPageFirst) { 
index = pages.size() - j - 1; 

} else { 

index = j; 

} 

printPage(&painter, pages, index); 

} 

} 

} 

} 

인쇄기설정과 painter 구성후에 처음으로 할 일은 paginate() 보조함수를 호출하여 어느 항목 
이 어느 폐지에 나타나야 하는가를 결정하는것이다 . 그 결과는 QStringList 들의 백토르로서 매 
개 QStringList 가 한 폐지에 대한 항목들을 보관한다 . 

례를 들면 꽃편람이 6 개의 항목을 포함하고 그것을 A, B, C, D, E, 표로서 참고한다고 가정 
하자 . 이제 첫 폐지에 A 와 표의 자리가 있고 둘째 폐지에 C, D, E, 셋째 폐지에 표의 자리가 있 
다고 가정 하자 . 그때 폐지벡토르는 첨 수위치 0 에 목록 [A, B], 첨 수위치 1 에 목록 [C, D, E], 첨 
수위치 2 에 목록 [피를 가질수 있다 . 

함수의 나머지는 printRichTextO 에서 처음에 수행 한것과 거의 같다 . 그러나 printPagef) 함수 
는 간단히 알수 있겠지만 다르다 . 

void PrintWindow: :paginate(QPainter *painter, vector<QS 仕 ingList> *pages, 
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const QStringList &entries) 



int pageHeight = painter->window().height() - 2 * LargeGap; 
int y = 0; 

QStringList: : const iterator it = entries.begin(); 
while (it != entries.end()) { 

int height = entryHeight(painter, *it); 
if (y + height > pageHeight && !currentPage.empty()) { 
pages->push_back(currentPage); 
currentPage.clear(); 
y = 0; 

} 

currentPage.push_back(*it); 
y += height + MediumGap; 

++it; 

} 

if (!currentPage.empty()) 

pages->push_back(currentPage); 


} 

paginate 함수는 꽃편람항목들을 폐지들에 분배한다 . 이것은 한 항목의 높이를 계산하는 
entryHeight () 함수에 기초하고있다 . 
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I ■을 순환하면서 적합하지 않은 항목에 올 때까지 현재 폐지에 그것들을 추가 ' 
지를 폐지벡토르에 추가하고 새 폐지를 시작한다 . 
intWindow: : entryHeight(QPainter *painter, const QString &entry) 


QStringList fields = QStringList::split(": ", entry); 

QString title = fields[0]; 

QString body = fields[l]; 

int textWidth = painter->window().width() - 2 * SmallGap; 
int maxHeight = painter->window() .height(); 
painter->setF ont (titleF ont); 

QRect titleRect = painter->boundingRect(0, 0, textWidth, maxHeight, WordBreak, title' 
painter->setF ont(bodyF ont); 

QRect bodyRect = painter->boundingRect(0, 0, textWidth, maxHeight, WordBreak, boc 
return titleRect.height() + body Rect.heightQ + 4 * SmallGap; 


yHeight() 함수는 QPainten:boundingRect() 에 의하여 한개 항목에 필요한 수직공간 - 
그림 8-19 는 꽃항목의 배치와 SmallGap 와 MediumGap 상수들의 의미를 보여준다 . 
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그림 8-19. 꽃항목의 배치 


void PrintWindow: : printPage(QPainter *painter, const vector<QStringList> &pages, int index) 

{ 

painter->saveWorldMatrix(); 
painter->translate(0, LargeGap); 

QStringList: : const iterator it = pages [index] .begin(); 
while (it != pages[index].end()) { 

QStringList fields = QStringList::split( n : ", *it); 

QString title = fields[0]; 

QString body = fields[l]; 
printBox(painter, titleFont, title, lightGray); 
printBox(painter, bodyFont, body, white); 
painter->translate(0, MediumGap); 

++it; 


} 

painter->restoreWorldMatrix(); 

painter->setFont(footerFont); 

painter->drawText(painter->window(), AlignHCenter | AlignBottom, 



printPageO 함수는 꽃편람항목들을 모두 순환하면서 printBoxO 를 두번 호줄하여 제목(꽃이 
름)과 본체 ( 설명)를 출력한다 . 또한 이때 폐지바닥의 중심에 폐지번호를 그린다 . 

void PrintWindow: : printBox(QPainter *painter, const QFont &font, const QString &str, 
const QBrush &brush) 
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painter->setF ont(font); 
int box Width = painter->window(). width(); 
int textWidth = boxWidth -2 * SmallGap; 
int maxHeight = painter->window() .height(); 

QRect textRect = painter->boundingRect(SmallGap, SmallGap, textWidth, maxHeight, 
WordBreak, str); 

int boxHeight = textRect.height() + 2 * SmallGap; 
painter->setPen(QPen(black, 2, SolidLine)); 
painter->setBrush(brush); 
painter->drawRect(0, 0, boxWidth, boxHeight); 
painter->drawText(textRect, WordBreak, str); 
painter->translate(0, boxHeight); 

} 

printBox () 함수는 직 4 각형의 틀선을 그린 다음 칸에 본문을 그린다 . 

사용자가 긴 문서를 인쇄하거나 짧은 문서를 여러개 요구한다면 QProgressDialog 를 펼치 
여 사용자에게 (Cancel 을 찰칵하여 ) 인쇄조작을 취소할 기회를 주는것이 보통 좋다 . 여기에 이 
것을 수행하는 printFlowerGuideO 의 수정판이 있다 . 

void PrintWindow::printFlowerGuide(const QStringList &entries) 

{ 

if (printer. setup(this)) { 

QPainter painter(&printer); 
vector<QStringList> pages; 
int index; 

paginate(&painter, &pages, entries); 

int numSteps = printer.numCopies() * pages.size(); 

int step = 0; 

QProgressDialog progress(tr("Printing file...’’), tr(’’Cancel") ， numSteps, this); 
progress.setModal(true); 

for (int i = 0;i < (int)printer.numCopies();++i) { 
for (int j = 0;j < (int)pages.size();++j) { 
progress. setProgress(step); 
qApp->processEvents (); 
if (progress.wasCanceled()) { 
printer.abort(); 
return; 
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if (i > 0 II j > 0) 
printer.newPage(); 

if (printer.pageOrder() = QPrinter::LastPageFirst) { 
index = pages.size() - j - 1; 

} else { 

index = j; 

} 

printPage(&painter, pages, index); 

} 

} 

} 

} 

사용자가 Cancel 을 찰칵할 때 QPrinten:abortO 를 호출하여 인쇄조작을 중지한다 . 

제4절. OpenGL 에 의한 도형처리 

OpenGL 은 2 차원과 3 차원 도형처 리를 위한 표준 API 이다 . Qt 응용프로그람들은 Qt 의 QGL 모 
듈을 리용하여 OpenGL 도형을 그릴수 있다 . 이 절에서는 독자가 OpenGL 을 알고있다고 가정 
한다 . 

Qt 응용프로그람으로부터 OpenGL 에 의 한 도형 처 리 는 간단하다 . QGLWidget 의 파생 클라스 
를 만들고 가상함수들을 재정의하고 응용프로그람을 QGL 과 OpenGL 서고들에 련결하여야 한 
다 . QGLWidget 가 QWidget 로부터 계승되므로 우리가 이미 알고있는것의 대부분을 여전히 적용 
할수 있다 . 주요한 차이는 표준 OpenGL 함수들을 사용하여 QPainter 대신에 그리기를 수행한다 
는것이다 . 

그 작업방법을 보여주기 위하여 그림 8-20 에 보여주는 Cube 응용프로그람의 코드를 개괄 
한다 . 응용프로그람은 서 로 다른 색 의 면 을 가지 는 3 차원 정 6 면 체 를 표시한다 . 사용자는 마우 
스단추를 누르고 끌기하여 립방체를 회전시킬수 있다 . 사용자는 립방체의 한 면을 두번 찰칵 
하여 펼쳐지는 QColorDialog 로부터 색을 선택하여 면의 색을 설정할수 있다 . 



©0 0 Cube 



그림 8-20. Cube 응용프로그람 
class Cube : public QGLWidget 
{ 

public: 

Cube(QWidget ^parent = 0, const char *name = 0); 
protected: 

void initializeGL(); 

void resizeGL(int width, int height); 

void paintGL(); 

void mousePressEvent(QMouseEvent * event); 
void mouseMoveEvent(QMouseEvent *event); 
void mouseDoubleClickEvent(QMouseEvent * event); 
private: 

void draw(); 

int faceAtPosition(const QPoint &pos); 

GLfloat rotationX; 

GLfloat rotationY; 

GLfloat rotationZ; 

QColor faceColors[6]; 

QPoint lastPos; 

}； 

Cube 는 QGLWidget 를 계승한다 . initializeGL() ， resizeGL(), paintGL () 함수들은 QGLWidget 로부 
터 재정의된다 . 마우스사건처리함수들은 보통과 같이 QWidget 로부터 재정의된다 . QGLWidget 
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는 <qgl.h> 에서 정의된다 . 

Cube :: Cube(QWidget *parent, const char *name) : QGLWidget(parent, name) 

{ 

setFormat(QGLFormat(DoubleBuffer | DepthBuffer)); 

rotationX = 0; 

rotationY = 0; 

rotationZ = 0; 

faceColors[0] - red; 

faceColors[l] = green; 

faceColors[2] = blue; 

faceColors[3] = cyan; 

faceColors[4] = yellow; 

faceColors[5] = magenta; 

} 

구성자에서는 QGLWidget : setFonnatO 를 호출하여 OpenGL 현시상황을 지정하고 클라스의 
비 공개 변 수들을 초기 화한다 . 
void Cube :: initializeGL() 

{ 

qglClearColor(black); 

glShadeModel(GL_FLAT); 

glEnable(GL_DEPTH_TEST); 

glEnable(GL_CULL_FACE); 

} 

initializeGLQ 함수는 paintGL() 이 호출되기전에 한번 호출된다 . 이것은 OpenGL 묘사상황을 
설정하고 현시목록을 정의하며 다른 초기화를 수행한다 . 

모든 코드는 QGLWidget 의 qglClearColor() 함수호출을 제외하고는 표준 OpenGL 이다 . 표준 
OpenGL 로 고착시키려고 한다면 RGBA 방식에서는 glClearColor() 를， 색첨수방식에서는 
glClearIndex() 를 각각 대신에 호출한다 . 

void Cube: :resizeGL(int width, int height) 

{ 

glViewport(0, 0, width, height); 

glMatrixMode(GL_PROJECTION); 

glLoadIdentity(); 

GLfloat x = (GLfloat)width / height; 
glFrustum(-x, x, -1.0, 1.0, 4.0, 15.0); 





glMatrixMode(GL_MODELVIEW); 


resizeGL() 함수는 paintGL() 이 처 음으로 호출되 기 전에，그러 나 initializeGL() 이 호출된 후에 
한번 호출된다 . 이 것은 창문부품의 크기 에 따라 OpenGL 보기 구역，사영，다른 환경 을 설정할 
수 있는 위치이다 . 

void Cube::paintGL() 

{ 

glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); 
draw(); 

} 

paintGL() 함수는 창문부품을 다시 그려야 할 때마다 호출된다 . 이것은 

QWidget::paintEventO 와 비슷하지만 QPainter 함수들대신에 OpenGL 함수들을 사용한다 . 실제의 
그리기는 비공개함수 draw() 에 의해 수행된다 . 
void Cube::draw() 

{ 

static const GLfloat coords[6] [4] [3] = { 

{ { + 1 . 0 , - 1 . 0 , + 1.0 }，{ + 1 . 0 , - 1 . 0 , - 1.0 }，{ + 1 . 0 , + 1 . 0 , - 1.0 }, { + 1 . 0 , + 1 . 0 , + 1.0 } }, 

{ { -1.0, -1.0, -1.0 }，{ -1.0, -1.0, +1.0 }，{ -1.0, +1.0, +1.0 }，{ -1.0, +1.0, -1.0 } }， 

{ | + 1 . 0 , - 1 . 0 , - 1.0 }，{ - 1 . 0 , - 1 . 0 , - 1.0 }，{ - 1 . 0 , + 1 . 0 , - 1.0 }，{ + 1 . 0 , + 1 . 0 , - 1.0 } }, 

{ { - 1 . 0 , - 1 . 0 , + 1.0 }，{ + 1 . 0 , - 1 . 0 , + 1.0 }，{ + 1 . 0 , + 1 . 0 , + 1.0 }，{ - 1 . 0 , + 1 . 0 , + 1.0 } }， 

{ { -1.0, -1.0, -1.0 }，{ +1.0, -1.0, -1.0 }, { +1.0, -1.0, +1.0 }，{ -1.0, -1.0, +1.0 } }, 

{ I - 1 . 0 , + 1 . 0 , + 1.0 }, { + 1 . 0 , + 1 . 0 , + 1.0 }，{ + 1 . 0 , + 1 . 0 , - 1.0 }, { - 1 . 0 , + 1 . 0 , - 1.0 } }}; 

glMatrixMode(GL_MODELVIEW); 
glLoadIdentity(); 
glTranslatef(0.0, 0.0, -10.0); 
glRotatef(rotationX, 1 . 0 , 0.0, 0.0); 
glRotatef(rotationY, 0.0, 1.0, 0.0); 
glRotatef(rotationZ, 0.0, 0.0, 1.0); 
for (int i = 0; i < 6; ++i) { 
glLoadName(i); 
glBegin(GL_QUADS); 
qglColor(faceColors[i]); 
for (int j = 0; j < 4; ++j) { 

glVertex3f(coords[i]D*][0], coords[i][j][l], coords[i][j][2]) ; 









glEnd(); 


} 

} 

draw() 에서는 x, y f z 회 전 그리고 faceColors 배 렬에 보관된 색들을 고려 하여 직 6 면체를 그린 
다 . qglColorO 호출을 제외 한 모든것 이 표준 OpenGL 이 다 . 방식 에 따라서 OpenGL 함수들인 
glColor3d() 혹은 gllndex() 중 하나를 사용하였다 . 
void Cube::mousePressEvent(QMouseEvent *event) 

{ 

lastPos = event->pos(); 

} 

void Cube :: mouseMoveEvent(QMouseEvent *event) 

{ 

GLfloat dx = (GLfloat) (event->x() -lastPos.x()) / width(); 

GLfloat dy = (GLfloat) (event->y() -lastPos.y()) / height(); 

if (event->state() & LeftButton) { 
rotationX += 180 * dy; 
rotationY += 180 * dx; 
updateGL(); 

} else if (event->state() & RightButton) { 
rotationX += 180 * dy; 
rotationZ += 180 * dx; 
updateGL(); 

} 

lastPos = event->pos(); 

} 

mousePressEvent() 와 mouseMoveEvent() 함수들을 QWidget 로부터 재정의하여 사용자가 보기 
를 찰칵하고 끌기하여 회전할수 있게 한다 . 왼쪽 마우스단추는 사용자가 : c 와 y 축주위로 회전 
할수 있게 하고 오른쪽 마우스단추는 x 와 z 축주위를 회전할수 있게 한다 . 

rotationX, rotationY 혹은 rotationZ 변수들을 수정 한 다음 updateGL() 을 호출하여 배경을 다 
시 그린다 . 

void Cube :: mouseDoubleClickEvent(QMouseEvent *event) 

{ 

int face = faceAtPosition(event->pos());if (face != -1) { 

QColor color = QColorDialog::getColor(faceColors[face], this); 
if (color.isValid()) { 
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faceColors[face] = color; 
updateGL(); 

} 

} 

} 

mouseDoubleClickEventO 을 QWidget 로부터 재정의하여 사용자가 립방체의 한 면을 두번 
찰칵하여 면의 색을 설정하게 한다 . 비공개함수 faceAtPosition() 를 호출하여 유표아래에 배치 
된 립방체면을 결정한다 . 한 면을 두번 찰칵하면 QColorDialog::getColorO 를 호출하여 그 면의 
새로운 색을 얻는다 . 그다음 새로운 색으로 faceColors 배렬을 갱신하고 updateGLO 를 호출하여 
배경을 다시 그린다 . 

int Cube: : faceAtPosition(const QPoint &pos) 

{ 

const int MaxSize = 512; 

GLuint bufferfMaxSize]; 

GLint viewport[4]; 

glGetIntegerv(GL_VIEWPORT, viewport); 

glSelectBuffer(MaxSize, buffer); 

glRenderMode(GL_SELECT); 

glInitNames(); 

glPushName(O); 

glMatrixMode(GL 一 PROJECTION); 

glPushMatrix(); 

glLoadIdentity(); 

gluPickMatrix((GLdouble)pos.x(), (GLdouble) (viewport[3] -pos.y()), 5.0, 5.0, viewport); 
GLfloat x = (GLfloat)width() / height(); 
glFrustum(-x, x, -1.0, 1.0, 4.0, 15.0); 
draw(); 

glMatrixMode(GL_PROJECTION); 

glPopMatrix(); 

if (!glRenderMode(GL_RENDER)) 
return -1; 
return buffer[3]; 

} 

faceAtPosition() 함수는 창문부품우에서 일정한 위치에 있는 면의 번호를 돌려주며 그 위치 
에 면이 없으면 -1 을 돌려준다 . OpenGL 에서 이것을 결정하는 코드는 좀 복잡하다 . 본질적으 





로 OpenGL 의 포착능력의 우점을 리용하도록 GL_SELECT 방식으로 배경을 그리고 OpenGL 히 
트 (hit) 기록으로부터 면번호 ( 이름)를 얻는다 . 

여기에 main.cpp 이 있다 . 

#include <qapplication.h> 

#include "cube.h" 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 
if (! QGLFormat :: hasOpenGL()) 

qFatal(’’This system has no OpenGL support’’); 

Cube cube; 

cube.setCaption(QObj ect: :tr("Cube")); 

cube.resize(300, 300); 

app. setMainWidget(&cube); 

cube.show(); 

return app.exec(); 

} 

사용자의 체계가 OpenGL 을 유지하지 않으면 콘솔에 오유통보문을 출력하고 Qt 의 qFatal() 
대역함수에 의하여 중지한다 . 

응용프로그람을 QGL 및 OpenGL 서고들에 련결할 때 .pro 파일이 이 항목을 요구한다 . 
CONFIG += opengl 

이로서 Cube 응용프로그람을 끝낸다 .(QGL 모듈에 대한 더 자세한 정보는 QGLWidget, 
QGLFormat, QGLContext, QGLColormap 의 방조문서 를 보시 오 .) 




제 9 장. 끌어다놓기 


끌어 다놓기 (drag and drop ) 는 하나의 응용프로그람안에 서 혹은 서 로 다른 응용프로그람들사 
이 에 정 보를 전송하는 직 관적 인 방법 이 다 . 이 것은 흔히 자료의 이동 및 복사를 위한 오려 둠 
판기능과 함께 제공된다 . 

이 장에서는 Qt 응용프로그람에 끌어다놓기 기능을 추가하는 방법을 보여주는것으로 시작 
한다 . 그다음 끌어다놓기코드를 재리용하여 오려둠판기능을 실현한다 . 이 코드재리용은 두 기 
구가 각이 한 형 식 으로 자료를 제 공하는 추상기 초클라스인 QMimeSource 에 기 초하므로 가능하 
다 . 

제1절. 끌어다놀기의 허용 

끌어다놓기는 2 개의 다른 작용 끌기 (dragging ) 와 놓기 (dropping ) 로 이루어진다 . 창문부품들 
은 끌기자리로서，놓기자리로서 혹은 끌기와 놓기자리로서 선택될수 있다 . 

끌어 다놓기 는 응용프로그람들사이 에서 자료를 전송하기 위한 좋은 방법 이 다 . 그러 나 일부 
경우에는 Qt 의 끌어다놓기기능을 사용하지 않고 끌어다놓기를 실현할수 있다 . 수행하려는 일 
이 한개 응용프로그람의 하나의 창문부품안에서 이 동하는것 이 라면 창문부품의 마우스사건처 
리함수들을 재정 의 하는것 이 훨씬 더 간단하다 . 이 것은 8 장의 DiagramView 창문부품에서 사용 
한 수법이다 . 

첫 실례는 Qt 응용프로그람이 다른 응용프로그람에 의해 초기화된 끌기를 받아들이게 하 
는 방법 을 보여 준다 . Qt 응용프로그람은 QTextEdit 를 중심 창문부품으로 가지 는 기 본창문이 다 . 
사용자가 탁상이나 파일열람기로부터 파일을 끌고가서 응용프로그람에서 놓을 때 응용프로그 
람은 QTextEdit 에로 파일을 적재한다 . 

여기에 MainWindow 클라스의 정의가 있다 . 
class MainWindow : public QMainWindow 
{ 

Q_OBJECT 

public: 

MainWindow(QWidget ^parent = 0， const char *name = 0); 
protected: 

void dragEnterEvent(QDragEnterEvent *event); 

void dropEvent(QDropEvent *event); 
private: 

bool readFile(const QString &fileName); 

QString strippedName(const QString &fullFileName); 

QTextEdit *textEdit; 



}; 

MainWindow 클라스는 QWidget 로부터 dragEnterEvent() 와 dropEvent() 를 재정의한다 . 실례의 
목적 이 끌어 다놓기 를 보여 주는것 이 므로 기 본창문클라스에서 기 대 하는 기 능의 세 부를 생 략하 
였 다 . 

MainWindow::MainWindow(QWidget *parent, const char *name) : QMainWindow(parent, name) 

{ 

setCaption(tr("Drag File "))； 
textEdit = new QTextEdit ( 仕 lis); 
setCentralWidget(textEdit); 
textEdit->viewport() ->setAccep 江 ) rops (false); 
set AcceptDrops(tme); 

} 

구성 자에서 는 QTextEdit 를 창조하여 중심 창문부품으로 설 정 한다 . QTextEdit 의 보기 구역 에서 
놓기를 금지하고 기본창문에서 놓기를 허용한다 . 

(^TextEdit 에서 놓기를 금지 하는 리 유는 MainWindow 파생 클라스에서 자체로 끌어다놓기를 
처 리하려는데 있다 . 기정으로 QTextEdit 는 다른 응용프로그람들로부터 본문끌기를 받아들이고 
사용자가 그우에 파일을 놓으면 본문에 파일이름을 삽입한다 . 파일이름이 아니라 파일의 전 
체내용을 놓으러고 하므로 QTextEdit 의 끌어다놓기기능을 사용할수 없고 자체로 실현해야 한 
다 . 

놓기사건들은 자식으로부터 부모로 전달되므로 MainWindow 안에서 QTextEdit 용의 놓기사 
건들을 비롯하여 전체 기본창문용 놓기사건들을 얻는다 . 

void MainWindow :: dragEnterEvent(QDragEnterEvent * event) 

{ 

event->accept(QUriDrag::canDecode(event)); 

} 

dragEnterEvent() 는 사용자가 객체를 창문부품우로 끌고갈 때 호출된다 . 사건에 대하여 
acceptCtme) 를 호출하면 사용자가 놓기객체를 이 창문부품우에 놓을수 있다는것을 가리킨다 . 
accept(false) 를 호출하면 창문부품이 끌기 를 받아들일수 없다는것을 가리 킨다 . Qt 는 자동적 으로 
유표를 변경하여 그 창문부품이 타당한 놓기자리인가 아닌가를 사용자에게 알려준다 . 

여기서는 사용자가 파일들을 끌수 있게만 하려고 한다 . 그러기 위하여 파일끌기를 처리하 
는 Qt 클라스인 QUriDrag 에게 끌고가는 객체를 해석할수 있는가 묻는다 . 이 클라스는 HTTP 와 
FTP 경 로와 같은 만능자원식 별자 (universal resource identifier, URI) 에 더 일반적 으로 사용되 므로 
QUriDrag 라고 부론다 . 

void MainWindow: : dropEvent(QDropEvent * event) 



QS 仕 ingList fileNames; 

if (QUriDrag::decodeLocalFiles(event, fileNames)) { 
if (readFile(fileNames[0])) 

setCaption ( 仕 ("%1 -Drag File") .arg(strippedName(fileNames[0]))); 

} 

} 

dropEventO 는 사용자가 객체를 창문부품우에 놓을 때 호출된다 . 정 적 함수 
QUriDrag::decodeLocalFilesO 를 호출하여 사용자가 끌고있는 파일이름목록을 얻고 목록안의 첫 
파일 을 읽어 들인 다 . (둘째 인 수는 비 상수참고로 넘어 간다 .) 일 반적 으로 사용자들은 한번 에 하 
나의 파일만 끌기하지만 하나의 선택을 끌기하여 여러개의 파일을 끌기할수 있다 . 

또한 QWidget 는 dragMoveEvent() 와 dragLeaveEvent() 를 제 공하지 만 대 부분의 응용프로그람 
들에서 이것들을 재정의할 필요는 없다 . 

둘째 실례는 끌기 를 초기 화하고 놓기 를 받아들이 는 방법 을 설명한다 . 끌어 다놓기 를 유지 
하는 QListBox 의 파생클라스를 창조하고 그림 9-1 에 보여주는 Project Chooser 응용프로그람의 
부분품으로 사용한다 . 
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그림 9-1. Project Chooser 응용프로그람 

Project Chooser 응용프로그람은 사용자에 게 이 름들이 들어 있는 2 개 의 목록칸을 표시 한다 . 
매개의 목록칸은 하나의 프로젝트를 표시한다 . 사용자는 목록칸안에 이 름들을 끌어 다넣 음으 
로써 사람을 한 프로젝트에서 다른 프로젝트로 옮길수 있다 . 

끌어다놓기코드는 모두 QListBox 의 파생클라스에 배치된다 . 여기에 클라스정의가 있다 . 
class ProjectView : public QListBox 
{ 

Q_OBJECT 

public: 

Proj ectView(QWidget *parent, const char *name = 0); 
protected: 





void contentsMousePressEvent(QMouseEvent *event); 
void contentsMouseMoveEvent(QMouseEvent * event); 
void contentsDragEnterEvent(QDragEnterEvent *event); 
void contentsDropEvent(QDropEvent * event); 
private: 

void startDrag(); 

QPoint dragPos; 

}； 

Project View 는 QListBox 의 기초클라스 인 QScrollView 에서 선언된 4 개의 사건처리 함수들을 
재정의 한다 . 

ProjectView :: ProjectView(QWidget ^parent, const char *name) : QListBox(parent, name) 

{ 

viewport ()->setAcceptDrops(true); 

} 

구성 자에 서 는 QScrollView 보기 구역 우에 서 의 놓기 를 허 용한다 . 
void Proj ectView: : contentsMousePressEvent(QMouseEvent * event) 

{ 

if (event->button() = LeflButton) 
dragPos = event->pos(); 

QListBox: : contentsMousePressEvent(event); 

} 

사용자가 왼쪽 마우스단추를 찰칵할 때 마우스위치를 dragPos 비공개변수에 보관한다 . 
contentsMousePressEvent() 의 QListBox 의 실현을 호출하여 QListBox 가 보통과 같이 마우스누르 
기사건들을 처리할 기회를 가지도록 한다 . 

void ProjectView: : contentsMouseMoveEvent(QMouseEvent *event) 

{ 

if (event->state() & LeftButton) { 

int distance = (event->pos() -dragPos).manhattanLength(); 
if (distance > QApplication: :startDragDistance()) 
startDrag(); 

} 

QListBox::contentsMouseMoveEvent(event); 

} 

사용자가 왼쪽 마우스단추를 누른 상태에서 마우스유표를 이동할 때 끌기를 시작한다 . 이 
전의 마우스위치와 현재 왼쪽 마우스단추를 누른 위치사이의 거리를 계산한다 . 






그 거리가 QApplication 의 주어진 끌기시작거리(보통 4 화소)보다 크면 비공개함수 
startDragO 를 호출하여 끌기를 시작한다 . 이것은 사용자의 손이 떨리는것으로 인한 끌기의 시 
작을 피한다 . 

void Proj ectView :: startDragO 

{ 

QString person = currentText(); 

if (! person.isEmpty()) { 

QTextDrag *drag = new QTextDrag(person, this); 
drag->setSubtype("x-person"); 

drag->setPixmap(QPixmap::fromMimeSource("person.png")); 

drag->drag(); 

} 

} 

startDragO 에서는 부모로서 this 를 가지는 QTextDrag 형의 객체를 창조한다 . QTextDrag 클라스 
는 본문을 전송하기 위한 끌어 다놓기 객체를 표시한다 . 이 것은 어가 제 공하는 끌기 객체들의 
사전 정 의 형 들중의 하나이 고 다른것 들로서 QlmageDrag, QColorDrag, QUriDrag 를 포함한다 . 또한 
픽 스매프를 설정 하여 끌기 를 표시한다 . 픽 스매프는 끌기 가 진행되 는동안 유표를 따르는 작은 
그림 기 호이 다 . 

setSubtypeO 를 호출하여 객체의 MIME 형 의 보조형 을 x-person 으로 설정한다 . 이 것은 객체 
의 완전한 MIME 형을 text/x-person 으로 되게 한다 . setSubtype() 를 호출하지 않았다면 MIME 형 
은 text/plain 일수 있다 . 

표준 MIME 형 들은 IANA (Internet Assigned Numbers Authority ) 에 의 하여 정의 된다 . 이 것들은 
형과 사선으로 구분된 보조형으로 이루어진다 . text/x-person 과 같은 비표준형을 창조할 때 보 
조형 에 x- 앞붙이 를 추가할것을 권고한다 . MIME 형 들은 오려 둠판과 끌어 다놓기체계 에서 각이한 
형의 자료들을 식별하는데 쓰인다 . 

dragO 호출은 끌기조작을 시작한다 . 호출후에 QTextDrag 객체는 끌기조작이 끝날 때까지 존 
재한다 . Qt 는 끌기객체의 소유자를 가지며 그것이 더는 필요하지 않은데 놓지 않은 경우에도 
삭제 한다 . 

void ProjectView::contentsDragEnterEvent(QDragEnterEvent *event) 

{ 

event->accept(event->provides( n text/x-person n )); 

} 

ProjectView 창문부품은 text/x-person 형의 끌기를 시작할뿐아니 라 그러 한 끌기를 받아들인다 . 
끌기가 창문부품에 들어갈 때 정확한 MIME 형을 가지는가 검사하고 없으면 그것을 거부한다 . 

void Proj ectView: : contentsDropEvent(QDropEvent *event) 
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QString person; 

if (QTextDrag::decode(event, person)) { 

QWidget *fromWidget = event->source(); 

if (fromWidget && fromWidget != this && fromWidget->inherits( ,, ProjectView M )) { 
ProjectView *fromProject = (ProjectView *) fromWidget; 

QListBoxItem *item = fromProject->findItem(person, ExactMatch); 
delete item; 
insertItem(person); 

} 

} 

} 

contentsDropEventO 에서 는 QTextDrag::decode() 함수를 사용하여 끌기 에 의 해 날라온 본문을 
꺼낸다 . QDropEvent::source() 함수는 끌기를 시작하는 창문부품이 같은 응용프로그람의 부분이 
라면 그것의 지적 자를 돌려 준다 . 원천 창문부품이 목표창문부품과 다른데 ProjectView 이면 
delete 를 호출하여 원천창문부품으로부터 항목을 삭제하고 새로운 항목을 목표창문부품에 삽 
입한다 . 

제2절. 사용자정의끌기형의 유지 

지금까지의 실례들에서는 미리 정의된 Qt 클라스들에 기초하여 끌기자료를 보관해왔다 . 례 
를 들면 파일 끌기에 QUriDrag, 본문끌기에 QTextDrag 를 사용하였다 . 이 두개의 클라스들은 모 
든 끌기 객체들의 기초클라스인 QDragObject 를 계승한다 . QDragObject 자체는 MIME 형 자료를 
제공하는 추상클라스 QMimeSource 를 계승한다 . 

본문，화상， URI, 혹은 색 을 끌기 하려 면 Qt 의 QTextDrag, QlmageDrag, QUriDrag, QColorDrag 
클라스들을 사용할수 있다 . 그러나 사용자정의자료를 끌기하려면 미리 정의된 어느 클라스도 
적합지 않으므로 다음의 두가지 방법들중 하나를 선택해야 한다 . 

• 끌기를 QStoredDrag 객체에 2 진 자료로서 보관할수 있 다 . 

• QDragObject 의 파생클라스를 만들고 한조의 가상함수들을 재정의하여 자체의 끌기클라 
스를 창조할수 있다 . 

QStoredDrag 는 임의의 2 진자료를 보관하게 하므로 어떤 MIME 형 에서나 사용될수 있다 . 례 
를 들면 ASDF 형식으로 자료를 보관하는 2 진파일의 내용을 가지고 끌기를 시작하려면 다음의 
코드를 사용할수 있다 . 

void My Widget: : startDrag() 

{ 

QByteArray data = toAsdf(); 

if (!data.isEmpty()) { 




QStoredDrag *drag = new QStoredDrag( M octet-stream/x-asdf', this); 
drag->setEncodedData(data); 

drag->setPixmap(QPixmap :: fromMimeSo\irce( M asdf.png")); 
drag- 〉 drag(); 

} 

} 

QStoredDrag 에서 한가지 결함은 오직 하나의 MIME 형을 보관할수 있는것이다 . 같은 응용 
프로그람안에서 혹은 갈은 응용프로그람의 여 러 개의 실례 들사이 에서 끌어 다놓기 를 수행 한다 
면 이것은 그리 문제로 되지 않는다 . 그러나 다른 응용프로그람들과 간단하게 교제하려고 한 
다면 하나의 MIME 형으로도 충분하다 . 

또 하나의 결함은 마감에 끌기를 받아들이지 않는 경우에도 자료구조를 QByteArray 로 변 
환할 필요가 있는것이다 . 자료가 크면 이것은 응용프로그람이 매우 느리게 할수 있다 . 사용자 
가 실제로 끌기객체를 놓을 때에만 자료변환을 수행하는것이 더 좋다 . 

이 두 문제에 대한 해결대책은 QDragObject 의 파생클라스를 만들고 (가에서 끌기정보를 
얻는데 쓰이는 두개의 가상함수들인 fomiatO 와 encodedData () 를 재정의하는것이다 . 그 동작방 
법을 보여주기 위하여 직 4 각형의 QTable 선택에 하나이상의 세포의 내용을 보관하는 CellDrag 
클라스를 개발한다 . 

class CellDrag : public QDragObject 

{ 

public: 

CellDrag(const QString &text, QWidget *parent = 0, 

const char *name = 0); 

const char *format(int index) const; 

QByteArray encodedData(const char * format) const; 
static bool canDecode(const QMimeSource * source); 
static bool decode(const QMimeSource *source, QString &str); 

private: 

QString toCsv() const;QString toHtml() const; 

QString plainText; 

}； 

CellDrag 클라스는 QDragObject 를 계승한다 . 끌기에서 실제로 문제가 있는 2 개의 함수는 
format () 와 encodedData() 이다 . 엄격히 필요하지 않지만 canDecode () 와 decode () 정적 함수들을 제 
공하여 놓기할 때 자료를 꺼 내는것 이 편리 하다 . 

CellDrag::CellDrag(const QString &text, QWidget ^parent, const char *name) 

: QDragObj ect(parent, name) 




{ 

plainText = text; 

} 

CellDrag 구성자는 끌고있는 세포들의 내용을 표시하는 문자렬을 받아들인다 . 문자렬은 4 
장에 서 표계 산프로그람에 오려 둠판기 능을 추가할 때 사용한《타브와 새행》평 본문서 식 으로 되 
여 있다 . 

const char *CellDrag: : format(int index) const 

{ 

switch (index) { 
case 0: 

return ’’text/csv"; 
case 1: 

return "text/html"; 
case 2: 

return "text/plain’’; 
default: 

return 0; 



fomiat () 함수는 끌기에 유지된 각이한 MIME 형을 돌려주도록 QMimeSource 로부터 재정의 
된 다 .3 가지 형 즉 반점구분값 (comma-separated values, CSV), HTML, 평 본문을 유지 한다 . 

아가 끌기 에 의해 어 떤 MIME 형 들이 제공되 는가를 결정할 때 format ^ 가 null 지 적 자를 돌 
려줄 때까지 첨수파라메터 0 ， 1 ， 2 ,...을 넘기여 fomiat () 를 호출한다 . 

서식의 정확한 순서는 보통 아무런 관계도 없으나 가장 좋은 서식을 우선 넣는것이 좋다 . 
많은 서식을 유지하는 응용프로그람들은 흔히 처음으로 일치하는 서식을 리용한다 . 

QByteArray CellDrag::encodedData(const char ^format) const 

{ 

QByteArray data; 

QTextOStream out(data); 
if (qstrcmp(format, M text/CSV") == 0) { 
out « toCsv(); 

} else if (qstrcmp(format, "text/html") == 0) { 
out « toHTML(); 

} else if (qstrcmp(format, "text/plain") = 0) { 
out« plainText; 
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} 

return data; 

} 

encodedData() 함수는 주어 진 MIME 형 을 위 한 자료를 돌려 준다 . 서 식 파라메 터 의 값은 보통 
formatO 가 돌려준 하나의 문자렬이지만 모든 응용프로그람들이 미리 formatf；) 에 대하여 MIME 
형 을 검 사하지 않으므로 그것 을 가정할수 없다 . Qt 응용프로그람들에서 이 검 사는 보통 처 음에 
수행한것처 럼 QDragEnterEvent 나 QDragMoveEvent 에 대하여 provides() 를 호출하여 수행된다 . 

QString 을 QByteArray 로 변환하는 가장 좋은 수법은 QTextStream 을 사용하는것이다 . 문자 
렬 이 비 ASCII 문자들을 포함한다면 QTextStteam 은 부호화가 국부 8 비 트부호화라고 가정 한다 . 
(대부분의 유럽 나라들에서 이 것은 ISO 8859-1 혹은 KO 8859-15 를 의 미 한다 . 자세 한 내용은 15 
장 참고 .) 15 장에서 설명하는것처럼 흐름에 대하여 setEncoding() 혹은 setCodec() 를 호출하여 
다른 부호화를 사용하도록 할수 있다 . 

QString CellDrag::toCsv() const 

{ 

QString out = plainText; 
out.replace("\\", "\\\\")； 
out.replace("\"", "\\\"")； 
out.replace("\t", " V , V '")； 
out.replace("\n", "\"\n \"")； 
out.prepend("\""); 
out.append ("\"")； 
return out; 

} 

QString CellDrag::toHtml() const 

{ 

QString out = QStyleSheet: : escape(plainText); 

out.replace( M \t M , "<td>"); 

out.replace("\n", "\n<trxtd>"); 

out.prepend("<table>\n<tr><td>"); 

out.append("\n</table> M ); 

return out; 

} 

toCsv() 와 toHtmlO 함수들은 《타브와 새행》문자멸을 CSV 혹은 HTML 문자렬로 변환한다 . 
례를 들면 자료 
Red Green Blue 
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Cyan Yellow Magenta 


"Red", "Green", ’’Blue ，， 

"Cyan，，, "Yellow", "Magenta ，， 

로 변환되거나 

〈 table 〉 <tr><td>Red<td>Green<td>Blue <tr><td>Cyan<td>Yellow<td>Magenta </table> 

로 변환된다 . 

변환은 가장 간단한 방법 즉 QString :: replace () 에 의해 수행된다 . HTML 특수문자들을 확장 
하기 위 하여 QStyleSheet :: escapeO 정 적 편의함수를 사용한다 . 
bool CellDrag: : canDecode(const QMimeSource * source) 

{ 

return source->provides("text/plain"); 

} 

canDecodeO 함수는 주어 진 끌기 를 해 석 할수 있으면 true, 그렇 지 않으면 false 를 돌려 준다 . 
최대의 유연성을 위 하여 그 인수는 하나의 QMimeSource 이다 . QMimeSource 클라스는 
QDragObject, QDragEnterEvent, QDragMoveEvent, QDropEvent 의 기 초클라스이 다 . 

자료를 3 가지 서로 다른 서식으로 제공하지만 오직 평본문만 받아들인다 . 보통 그 리유는 
평 문이면 충분하기때문이 다 . 사용자가 세포들을 QTable 로부터 HTML 편집 기 에로 끌기 하면 세 
포들을 HTML 표로 변환하려고 한다 . 그러나 사용자가 임의의 HTML 을 QTable 로 끌기하면 그 
것을 받아들이려고 하지 않는다 . 

bool CellDrag: :decode(const QMimeSource * source, QString &s 仕 ) 

{ 

QByteArray data = source->encodedData("text/plain"); 
str = QString::fromLocal8Bit((const char *)data, data.size()); 
return !str.isEmpty(); 

} 

끝으로 decode () 함수는 text/plain 자료를 QString 으로 변환한다 다시 본문이 국부 8 비트부호 
화로 부호화된다고 가정한다 . 

정확한 부호화를 사용하려는것이 확실 하면 text/plain MIME 형의 charset 파라메 터를 리 용하 
여 명시적 인 부호화를 지 정할수 있다 . 여기 에 몇가지 실례가 있다 . 
text/plain;charset=US-ASCII 
text/plain;charset=ISO-8859 -1 
text/plain;charset=Shift_JIS 

QTextDrag 를 사용할 때 항상 UTF-8, UCS-2 (UTF-16), US-ASCII, 그리 고 국부 8 비 트부호화를 
반출하고 다른 부호화로부터 놓기를 받아들인다 . 이것을 고려하여 QTextDrag::decodeO 를 호출 
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하는것으로 CellDrag :: decodeO 를 간단히 실현 하는것이 더 깨끗하다 . 그러나 이 수법을 리 용해 
도 후에 확장하여 평본문외에 다른 형의 끌기(실례로 CSV 끌기)를 해석하려고 하는 경우에는 
여전히 CellDrag::decode() 를 QTextDrag::decode() 와 구별하여 제공한다 . 

이제는 CellDrag 클라스가 완성되였다 . 그것을 사용하기 위하여 QTable 과 통합한다 . QTable 
이 이 미 거 의 대부분의 작업 을 수행한다 . 우리 가 해 야 할 일은 그 파생클라스를 만들고 파생 
클라스의 구성자에서 setDragEnabled(true) 를 호출하고 CellDrag 를 돌려주도록 
QTable::dragObject() 를 재정의하는것이다 . 여기에 실례가 있다 . 

QDragObject *MyTable: : dragObject() 

{ 

return new CellDrag(selectionAsS 仕 ing(), this); 

} 

selectionAsStringO 의 코드는 Spreadsheet: : copy() 함수의 핵심과 갈으므로 여기서 보여주지 않 
는다 . 

QTable 에 놓기 기능을 추가하려면 Project Chooser 응용프로그람에 서와 같은 방법으로 conten 
tsDragEnterEvent() 와 contentsDropEvent() 를 재정의하여야 한다 . 

제3절. 오려품판의 고급한 조종 

대 부분의 응용프로그람들은 Qt 의 내 부오려 둠판조종기 능을 여 러 가지 방법 으로 리 용한다 . 
례를 들면 QTextEdit 클라스는 cut(), copy(), paste() 처 리부들에 의하여 Ctrl+X, Ctrl+C, Ctrl+V 기능 
들을 제공하므로 코드를 전혀 추가하지 않아도 된다 . 

자체의 클라스들을 쓸 때 응용프로그람의 QClipboard 객체의 지적자를 돌려주는 
QApplication :: clipboardO 를 통하여 오려둠판을 호출할수 있다 . 체계오려둠판의 조종은 간단하다 . 
setText(), setlmage() 혹은 setPixmap() 를 호출하여 자료를 오려둠판에 넣고 text(), image() 혹은 
pixmapO 를 호출하여 자료를 얻는다 . 이미 4 장의 표계산프로그람과 8 장의 Diagram 프로그람에 
서 오려둠판의 실례들을 보았다 . 

어떤 응용프로그람들에서는 내부기능만으로 충분하지 못하다 . 례를 들면 본문이나 화상이 
아닌 자료를 주려고 한다 . 또는 다른 응용프로그람들과의 최대한의 호상운영을 위하여 서로 
다른 수많은 서식의 자료를 제공하려고 할수 있다 . 문제는 초기에 끌어다놓기에서 제기된것 
과 비숫하며 그 대답도 비숫하다 . 즉 QMimeSource 의 파생클라스를 만들고 formatO 와 
encodedData() 를 재 정 의 한다 . 

응용프로그람이 끌어 다놓기 기 능을 가지 고있다면 QDragObject 의 사용자정 의 파생클라스를 
간단히 재리용하고 setDataO 함수에 의하여 그것을 오려둠판에 넣을수 있다 . QDragObject 가 
QMimeSource 를 계승하고 오려 둠판이 QMimeSource 들을 리 해하면 이 것은 원만히 작업한다 . 

례를 들면 여기에 QTable 의 파생클라스의 copyG 함수를 실현하는 방법이 있다 . 

void MyTable::copy() 




QApplication: :clipboard()->setData(dragObj ect()); 


} 

앞절의 마감에 선택된 세포들의 내용을 보관하는 CellDrag 를 돌려주도록 dragObject() 를 실 
현하였다 . 

자료를 얻기 위하여서는 오려둠판에 대하여 dataO 를 호출한다 . 여기에 QTable 파생클라스 
의 pasteO 함수를 실현하는 방법이 있다 . 
void MyTable::paste() 

{ 

QMimeSource * source = Q Application: : clipboard() ->data(); 

if (CellDrag:xanDecode(source)) { 

QString str; 

CellDrag::decode(source, str); 
performPaste(str); 

} 

} 

perfomiPasteO 는 본질적으로 4 장에서 제시한 Spreadsheet::paste() 함수와 같다 . 

이것은 사용자정 의 QMimeSource 중에서 사용자정의 형의 오려둠판기 능을 추가하는데 필요 
한 전부이다 . 

XII 오려둠판은 Windows 나 Mac OS 표에서 사용할수 없는 추가적인 기능을 제공한다 . XII 
에서는 보통 3 개단추마우스의 중간단추를 찰칵하여 선택내용을 붙이기할수 있다 . 이것은 개 
별적인 〈〈선택》오려둠판에 의해 수행된다 . 자기의 창문부품들이 표준오려둠판은 물론 이러한 
종류의 오려둠판을 유지 하려 고 한다면 여 러 가지 오려둠판호출에 추가인수로서 

(^Clipboard::Selection 을 넘겨야 한다 . 례를 들면 여기에 본문편집기에서 중간마우스단추에 의 
한 붙이기기능을 유지하도록 mouseReleaseEvent() 를 재정의하는 방법이 있다 . 
void MyTextEditor::mouseReleaseEvent(QMouseEvent *event) 

{ 

QClipboard * clipboard = Q Application: :clipboard(); 

if (event->button() = MidButton && clipboard->supportsSelection()) { 

QString text = clipboard->text(QClipboard: : Selection); 
pasteText(text); 

} 

} 

Xll 에서 supportsSelectionO 함수는 true 를 돌려준다 . 다른 가동환경들에서는 false 를 돌려준 


다 . 



제 10 장. 입력과 출력 


이 장에서는 파일의 읽기와 쓰기，파일체계의 항행 , 외부프로그람들과의 호상교제에 대하 
여 설명한다 . 

Qt 의 QDataStteam 과 QTextS 仕 earn 클라스들은 파일을 간단히 읽고 쓰게 한다 . 이 클라스들 
은 바이 트순서 화와 본문부호화와 갈은 문제 들을 고려 하여 각이한 가동환경 에서 실 행 하는 Qt 
응용프로그람들이 파일들을 읽고 쓸수 있게 한다 . 

수많은 응용프로그람들은 등록부를 항행하거나 파일에 대한 정보를 얻어야 한다 . 어의 
QDir 와 QFilelnfo 클라스들이 이것을 가능하게 한다 . 

일부 상황에서는 GUI 프로그람내에서 외부프로그람들을 실행해야 한다 . Qt 의 QProcess 클라 
스는 GUI 응답성을 유지하면서 외부프로그람들을 신호들과 비동기적으로 실행되게 한다 . 

제1절. 2진자료의 읽기와 쓰기 

QDataStream 에 의 한 2 진자료의 읽 기와 쓰기는 (가에서 사용자정의자료를 적재하고 보관하 
는 가장 간단한 방법 이 다 . QDataStream 은 QByteArray, QFont, Qlmage, QMap<K, T>, QPixmap, 
QString, QValueList<T>, QVariant 를 비 롯한 수많은 Qt 자료형 들을 유지 한다 . 

2 진자료의 취급방법을 보여주기 위하여 2 개의 실례클라스 즉 Drawing 과 Gallery 를 리용한 
다 . Drawing 클라스는 그림 에 대 한 기 초정 보(저 자의 이 름，제 목，창작년도)를 보유하고 Gallery 클 
라스는 Drawing 들의 목록을 보관한다 . 

Gallery 클라스로부터 시 작하자 . 

class Gallery : public QObject { 

public: 

bool loadBinary(const QString &fileName); 
bool saveBinary(const QString &fileName); 


private: 

enum { MagicNumber = 0x98c58f26 }; 

void writeToStream(QDataStream &out); 

void readFromStream(QDataStream &in); 

void error(const QFile &file, const QString &message); 

void ioError(const QFile &file, const QString &message); 

QByteArray getData(); 

void setData(const QByteArray &data); 

QString toString(); 

std: :list<Drawing> drawings; 





}; 

Gallery 클라스는 자료를 보관하고 적 재 하기 위한 공개 함수들을 포함한다 . 자료는 drawings 
자료성원에 보관된 그림들의 목록이다 . 비공개함수들은 그것들을 사용할 때 설명한다 . 

여기 에 Gallery 의 그림들을 2 진자료로 보관하기 위한 간단한 함수가 있다 . 
bool Gallery : :saveBinary(const QString &fileName) 

{ 

QFile file(fileName); 

if (!file.open(IO WriteOnly)) { 

ioError(file, tr( n Cannot open file %1 for writing")); 
return false; 

} 

QDataStream out(&file); 
out.setVersion(5); 

out « (Q_UINT32)MagicNumber; 
writeTo Stream(out); 
if (file.status() != IO Ok) { 

ioError(file, tr( M Error writing to file %1")); 
return false; 

} 

return true; 

} 

파일을 열고 그 파일을 QDataStream 의 목표로 만든다 . QDataStteam 의 판을 5 (Qt 3.2 에서 
제 일 최 근 판)로 설 정한다 . 판번 호는 Qt 자료형 들을 표시 하는 방법 에 영 향을 준다 . C 나기 본자 
료형들은 늘 같은 방법으로 표시된다 . 

그다음 Gallery 파일 형 식 을 식 별하는 수 (MagicNumber) 를 출력한다 . 모든 가동환경 에 서 수가 
32 비 트옹근수로 씌여 진다는것을 담보하기 위 하여 수를 정 확히 32 비 트로 만드는 자료형 인 
Q_UINT32 로 강제변 환한다 . 

파일본체는 writeToStreamO 비공개함수에 의해 써넣 어진다 . 파일을 정확히 닫을 필요가 없 
고이것은 QFile 변수가 함수끝에서 리용범위밖으로 벗어날 때 자동적으로 수행된다 . 

writeToStteamf} 호출후에 QFile 장치의 상태를 검사한다 . 오유가 있으면 ioErrorO 를 호출하여 
사용자에게 통보창을 표시하고 false 를 돌려준다 . 

void Gallery: : ioError(const QFile &file, const QString &message) 

{ 


error(file, message + file.errorS 仕 ing()); 




ioError () 함수는 일반적인 error () 함수를 호출한다 . 

void Gallery: : error(const QFile &file, const QString &message) 

{ 

QMessageBox: : waming(0, tr(’’Gallery"), message.arg(file.name())); 

} 

이제는 writeToStreamO 함수를 고찰하자 . 
void Gallery: : writeToStream(QDataStream &out) 

{ 

list<Drawing>: : const iterator it = drawings .begin(); 
while (it != drawings.end()) { 



} 

} 

writeToStreamO 함수는 Gallery 의 그림들을 모두 순환하면서 Drawing 클라스의 « 연산자에 
기 초하여 주어 진 흐름에 그것 들을 출력 한다 . 그림 들을 보관하는데 list<Drawing> 대 신 에 
리용한다면 순환을 생략하고 간단히 다음과 같이 쓰면 된다 . 

out « drawings; 

QValueList<T> 가 흐름에 흐를 때 목록에 보관된 매개 항목은 항목형의 «연산자에 의하 
여 출력된다 . 

QDataStream &operator«(QDataStream &out, const Drawing &drawing) 

{ 

out « drawing.myTitle « drawing.myArtist « drawing.myYear; 
return out; 

} 

Drawing 을 출력하기 위해서는 세개 비공개성원변수들 즉 myTitle, myArtist, my Year 를 간단 
히 출력한다 . 그러 기 위 하여 operator«0 를 Drawing 의 동료로서 선 언 할 필요가 있다 . 함수의 
끝에서 흐름을 돌려준다 . 이것은 C++ 의 일반적인 관례로서 출력흐름과 함께 여러개의 « 연 
산자들을 련이어 쓸수 있게 한다 . 례를 들면 

out « drawing 1 « drawing2 « drawing3; 

Drawing 클라스의 정의는 다음과 같다 . 
class Drawing 
{ 

friend QDataStream &operator«(QDataStream &, const Drawing &); 
friend QDataStream &operator»(QDataStream &, Drawing &); 
public: 




Drawing() { my Year = 0;} 

Drawing(const QString &title, const QString &artist, int year) 
{ myTitle = title;myArtist = artist;myYear = year; } 
QString title() const { return myTitle; } 
void setTitle(const QString &title) { myTitle = title; } 

QString artist() const { return myArtist; } 

void setArtist(const QString &artist) { myArtist = artist; } 

int year() const { return my Year;} 

void setYear(int year) { myYear = year; } 



QString myTitle;QString myArtist;int myYear; 

}； 

그러 면 Gallery 파일로부터 자료를 읽어 들이 는 방법 을 고찰하자 . 

bool Gallery : :loadBinary(const QString &fileName) 

{ 

QFile file(fileName); 

if (! file .open(IO ReadOnly)) { 

ioError(file, tr(’’Cannot open file %1 for reading")); 
return false; 

} 

QDataStream in (&file); 

in.setVersion(5); 

Q—UINT32 magic; 

in » magic; 

if (magic != MagicNumber) { 

error(file, tr(’’File %1 is not a Gallery file’’)); 
return false; 



if (file.status() != 10 一 Ok) { 

ioError(file, tr("Error reading from file %1")); 
return false; 

} 

return true; 
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읽 으러는 파일을 열고 파일로부터 자료를 읽어 들이기 위한 QDataStteam 을 창조한다 . 
QDataStream 의 판번호를 5 로 설 정 한다 . 그것 은 이 판을 써 넣 는데 사용했기 때 문이 다 . 고정 판번 
호 5 를 사용하여 응용프로그람이 항상 자료를 읽고 쓸수 있다는것을 담보함으로써 Qt 3.2 이후 
의 판에서 콤파일할수 있게 한다 . 

우리가 써넣은 식별번호를 읽어들여 그것을 MagicNumber 와 비교한다 . 이것은 실제로 
Gallery 파일 을 읽어 들이 고 있다는것 을 담보한다 . 그다음 readFromStteamO 함수에 의해 자료를 
읽 어들인다 . 

void Gallery: :readFromStream(QDataStream &in) 

{ 

drawings.clear();while (!in.atEnd()) { 

Drawing drawing; 

in » drawing; 

drawings.pushback(drawing); 

} 

} 

readFromStreamO 에서는 우선 현존자료를 삭제 한다 . 그다음 »연산자에 기초하여 한번에 
하나의 그림을 읽어들이고 Gallery 의 그림목록에 매개를 추가한다 . 자료를 보관하는데 
list<Drawing> 이 아니 라 QValueLisKDrawing；^ 사용한다면 순환없이 모든 그림 을 읽 어 들일수 
있다 . 즉 


in » drawings; 

QValueList<T> 는 항목형의 >>연산자에 기 초하여 항목들을 읽어 들인다 . 
QDataStream &operator»(QDataStream &in, Drawing &drawing) 

{ 



} 

>> 연산자의 실현은 « 연산자의 실현과 비슷하다 . QDataStream 를 사용할 때 어떤 종류의 
문법해석도 필요없다 . 

2 진자료를 읽고 쓰러고 한다면 QDataS 仕 earn 을 통하여 바이트블로크를 읽고쓰는데 
readRawBytes() 와 writeRawBytesO 를 사용할수 있다 . 바이트들앞에 블로크크기가 놓이지 않는 
다 . 

기본형 (Q_UINT16 혹은 float 등)에 대하여 »와 «연산자를 사용하거나 readRawBytes() 와 
writeRawBytesO 를 리 용하여 DBF 파일과 TEX DVI 파일들과 같은 표준 2 진형 식 들을 읽어 들이 고 
써 넣 을수 있다 . QDataStream 에서 사용되 는 기 정 바이 트순서 화는 비 그엔디 안 (big-endian) 이 다 . 리 
틀엔디안 (little-endian) 으로 자료를 읽고 쓰러면 다음과 같이 호출해야 한다 . 




stream. setByteOrder(QDataStream: : LittleEndian); 

QDataStream 이 기본 C++ 자료형을 읽고쓰는데만 사용되고있다면 setVersionQ 을 사용할 필요 
가 없다 . 

파일을 한번에 읽거나 써넣으려면 QDataStream 의 리용을 피하고 그대신에 QFile 의 
writeBlock() 와 readAllQ 함수들을 사용한다 . 례를 들면 
file.writeBlock(getData()); 

이려한 방법으로 써넣은 자료는 바이트렬이다 . 자료를 써넣을 때 그것을 구조화하고 자료 
를 다시 읽 어 들일 때 그것 을 해 석 한다 . Gallery 의 비 공개 getData() 함수에 기 초하여 QByteArray 
를 창조하고 거기 에 자료를 옳긴다 . 자료를 읽어들이는것은 간단하다 . 즉 
setData(file.readAll()); 

QByteArray 에 정보를 설정하는데 Gallery 의 setData() 함수를 사용한다 . 

QByteArray 에 모든 자료를 보관하면 더 많은 기억기를 요구하지만 몇가지 우점이 있다 . 
례를 들면 어의 qCompressO 함수를 리용하여 자료를 압축 (zlib 사용)할수 있다 . 즉 
file.writeBlock(qCompress(getData())); 

그다음 qUncompressO 를 사용하여 자료를 풀수 있다 . 즉 
setData(qUncompress(file.readAll())); 

getData() 와 setData() 를 실현하는 한가지 방법은 QByteArray 에 대하여 QDataStream 을 사용 
하는것이다 . 여기에 getData() 가 있다 . 

QByteArray Gallery: :getData() 

{ 

QByteArray data; 

QDataStream out(data, IO WriteOnly); 

writeToStream(out); 

return data; 

} 

QFile 이 아니라 QByteArray 에 써넣는 QDataStream 을 창조하고 2 진자료를 배렬에 채우기 
위하여 처음에 사용한 writeToStreamO 함수를 사용한다 . 

마찬가지로 setData() 함수는 처음에 작성 한 readFromStreamO 함수를 사용한다 . 
void Gallery: : setData(const QByteArray &data) 

{ 

QDataStream in(data, IO ReadOnly); 
readFromStream(in); 


처음의 실례들에서 흐름의 판을 5 로 고정하여 자료를 적재하고 보관하였다 . 이 수법은 간 
단하고 안전하지만 하나의 자그마한 결함이 있다 . 즉 새롭거나 갱신된 형식들의 우점을 사용 



할수 없다 . 례를 들면 Qt 의 후판에 QFont 부분품(즉 서체의 점크기 , 계렬 등)이 새로 추가되였 
다면 그 부분품은 보관되거나 적재되지 않는다 . 

하나의 대책은 파일에 QDataStream 판번호를 보관하는것이다 . 즉 
QDataStream out(&file); 
out « (Q_UINT32)MagicNumber; 
out « (Q_UINT 16)out.version(); 
writeToStream(out); 

이것은 어떤 일 이 생겨도 QDataStream 의 가장 최근판을 사용하여 자료를 늘 써넣는다는 
것을 담보한다 . 

파일을 읽으러고 할 때 식별번호와 흐름판을 읽는다 . 즉 
QDataStream in(&file); 

Q_UINT32 magic; 

Q UINT16 streamVersion; 
in » magic » streamVersion; 
if (magic != MagicNumber) { 

error(file, tr("File %1 is not a Gallery file，，)); 
return false; 

} else if ((int)streamVersion > in.version()) { 

error(file, tr("File %1 is from a more recent version of the application")); 
return false; 

} 

in. setVersion(streamVersion); 
readFromStream(in); 

흐름판이 응용프로그람에 의해 사용된 판보다 작거나 갈으면 자료를 읽 어들일수 있다 . 그 
렇지 않으면 오유를 알린다 . 

파일형식이 자체의 판번호를 포함한다면 그것을 흐름판번호대신에 사용할수 있다 . 례를 
들면 파일형식이 응용프로그람의 1.3 관용이라고 가정하자 . 그때 자료를 다음과 같이 쓸수 있 
다 . 

QDataStream out(&file); 
out.setVersion(5); 

out « (Q_UINT32)MagicNumber; 
out « (Q_UINT16)0x0103; 
writeToStream(out); 

자료를 읽어들일 때 응용프로그람의 판번호에 기초하여 어느판의 QDataStream 을 사용하 
는가 결 정한다 . 즉 



QDataStream in(&file); 

Q_UINT32 magic; 

Q UINT16 appVersion; 
in » magic » app Version; 
if (magic != MagicNumber) { 

error(file, tr(，，File %1 is not a Gallery file，，)); 
return false; 

} else if (appVersion > 0x0103) { 

error(file, tr("File %1 is from a more recent version of the application")); 
return false; 

} 

if (appVersion <= 0x0102) { 
in.setVersion(4); 

} else { 

in.setVersion(5); 

} 

readFromStream(in); 

이 실례에서는 1.2 판이전의 응용프로그람들에서 보관한 파일이 자료흐름판 4 를 사용한다 
는것과 1.3 판의 응용프로그람에서 보관한 파일들이 자료흐름판 5 를 사용한다 . 

QDataStream 판조종방략이 있으면 방에 의한 2 진자료의 읽고쓰기는 간단하고 믿음성있다 . 

제2절. 본문의 읽기와 쓰기 

Qt 는 본문자료를 읽 고쓰기 위한 QTextStteam 클라스를 제 공한다 . 평 본문파일들이나 HTML, 
XML, 원천파일들과 같은 다른 형식의 파일들을 읽고쓰는데 QTextStream 을 사용할수 있다 . 이 
클라스는 유니코드와 체계의 국부 8 비트부호화사이의 변환을 고려하며 서로 다른 조작체계들 
에서 사용되는 서로 다른 행끝처리를 알기 쉽게 진행한다 . 

QTextStteam 은 자료의 기본단위로서 QChar 를 사용한다 . 문자와 문자렬외에 QTextStteam 은 
C++ 의 기본수값형을 유지하며 그것들과 문자렬사이를 변환한다 . 

QTextStream 의 사용법을 보여주기 위하여 앞절의 Gallery 실례를 계속한다 . 여기에 Gallery 
로부터 그림자료들을 보관하는 saveText() 함수의 코드가 있다 . 
bool Gallery : :saveText(const QString &fileName) 

{ 

QFile file(fileName); 

if (!file.open(IO_WriteOnly | IO Translate)) { 

ioError(file, tr("Cannot open file %1 for writing’’)); 



QTextStream out(&file); 
out.setEncoding(QTextStream::UnicodeUTF8); 
list<Drawing>: : const iterator it = drawings .begin(); 
while (it != drawings.end()) { 
out « *it; 

++it; 

} 

if (file.status() != IO Ok) { 

ioError(file, 仕 ("Error writing to file %1 "))； 
return false; 

} 

return true; 

} 

IO_Translate 기발을 사용하여 파일을 열 때 새 행문자를 목표가동환경의 정확한 문자렬 
(Windows 에서 "V\n", Mac OS 표에서 "V’) 로 변환한다 . 그다음 전체 유니코드문자모임을 표시 할 
수 있는 ASCII 호환부호화인 UTF-8 로 부호화를 설정한다 . (유니코드에 대한 자세 한 정보는 15 
장 참고 .) 출력을 조종하려면 <<연산자에 기초하여 Gallery 안의 매개 그림을 순환한다 . 
QTextStream &operator«(QTextStream &out, const Drawing &drawing) 

{ 

out « drawing.myTitle « « drawing.myArtist « 

<< drawing.myYear < 타 : endl; 
return out; 

} 

그림을 써넣을 때에는 하나의 두점을 리용하여 그림의 제목과 저자의 이름을 분리하고 
다른 두점으로 저자의 이름과 년도를 분리하며 새행으로 자료를 끝낸다 . 제목과 저자의 이름 
은 두점 또는 새행을 포함하지 않는것으로 가정한다 . 

여기 에 saveTextO 에 의한 실례파일출력 이 있다 . 

The False Shepherds:Hans Bol:1576 
Panoramic Landscape Jan Brueghel the Younger: 1619 
Dune Landscape Jan van Goyen:1630 
River Delta:Jan van Goyen:1653 
그러면 파일에서 자료를 읽는 방법을 고찰하자 . 
bool Gallery: :loadText(const QString &fileName) 



QFile file(fileName); 

if (! file.open(IO_ReadOnly | IO Translate)) { 

ioError(file, tr("Cannot open file %1 for reading")); 
return false; 

} 

drawings.clear(); 

QTextStream in(&file); 
in.setEncoding(QTextStream::UnicodeUTF8); 
while (!in.atEnd()) { 

Drawing drawing; 

in » drawing; 

drawings.pushback(drawing); 

} 

if (file.status() != IO_Ok) { 

ioError(file, tr("Error reading from file %1")); 
return false; 

} 

return true; 

} 

훙미 있는 부분은 while 순환이 다 . 유효자료가 있는동안 >>연산자에 의 하여 읽 어 들인다 . 

>>연산자의 실현은 그리 간단하지 않다 . 다음의 실례를 고찰하자 . 
out « "alpha” « "bravo"; 

out 가 QTextStream 이면 실제로 써 넣 어지는 자료는 문자렬 ’’alphabravo" 이다 . QTextStream 에 
서 읽어들일 때 실제로 이것을 기대할수 없다 . 
in » strl » s 仕 2; 

사실상 그때 발생하는 일은 s 仕 1 의 전체 단어 ’’alphabravo " 를 얻고 s 仕 2 은 아무것도 없다 . 
QDataStteam 은 문자자료의 앞에 매개 문자렬의 길이를 보관하므로 문제가 없다 . 

써넣은 본문이 하나의 단어로 이루어지면 그것들사이에 공백을 넣고 단어별로 자료를 읽 
을수 있다 . (8 장의 DiagramView :: copy () 와 DiagramView :: paste () 함수는 이 수법 을 사용한다 .) 저 자 
의 이름과 그림의 제목은 보통 1 개이상의 단어를 포함하므로 그림의 경우에 이것을 수행할수 
없다 . 그리 하여 매 개 행 을 전부 읽어 들이 고 그것 을 QStringListxsplitO 에 의해 마당들로 분리한 
다 . 

QTextStream &operator»(QTextStream &in, Drawing &drawing) 

{ 


QString s 仕 = in.readLineQ; 
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QStringList fields = QStringList: : split(" : M , str); 
if (fields.size() == 3) { 

drawing.myTitle = fields [0]; 
drawing.myArtist = fields[l]; 
drawing.myYear = fields[2].toInt(); 

} 

return in; 

} 

QTextStream :: readO 를 사용하여 한번에 전체 본문을 읽을수 있다 . 

QString wholeFile = in.read(); 

결과문자렬에서 매개 행의 끝은 읽어들이는 파일에 의해 사용되는 행마감관례에 관계없 
이 새행문자 (’ \n’) 로 지정된다 . 

전체 본문파일의 읽기는 자료를 앞처리하여야 하는 경우에 아주 편리하다 . 례를 들면 
wholeFile.replace( M & M , ，，&"); 
wholeFile.replace( M < M , 
wholeFile.replace 

한번에 써넣기 위하여 자료를 모두 하나의 문자렬에 넣고 그것을 한번에 출력한다 . 

QString Gallery : :saveToString() 

{ 

QString result; 

QTextOStream out(&result); 

list<Drawing>: : const iterator it = drawings .begin(); 
while (it != drawings.end()) { 
out « *it; 

++it; 

} 

return result; 

} 

본문을 파일에 출력하는것처럼 문자렬에 본문을 출력하는것은 간단하며 역시 «연산자에 
기초한다 . 

void Gallery: : readFromString(const QString &data) 

{ 


QString string = data; 
drawings.clear(); 
QTextIStream in(&string); 





while (!in.atEnd()) { 

Drawing drawing; 

in » drawing; 

drawings.pushback(drawing); 

} 

} 

QTextS 仕 earn 에 의하여 문자렬에서 자료를 발취하는것은 간단하다 . >>연산자에 의거하므로 
문장해석은 필요없다 . 

본문자료의 써넣기는 어렵지 않지만 본문읽기는 잘 되지 않는다 . 복잡한 형식에 대해서는 
완전확장된 문장해석 기 가 필요하다 . 일반적 으로 그러한 문장해석 기 는 QChar 에 대하여 >>에 
의 해 한 문자씩 자료를 읽어 들이거 나 readLine() 에 의 하여 한 행씩 자료를 읽어 들이 고 돌아온 
QString 을 순환하면서 작업한다 . 

제3절. 파일과 등록부의 조종 

Qt 의 QDir 클라스는 등록부를 항행 하면서 파일들에 대 한 정 보를 얻 기 위한 가동환경 에 의 
존하지 않는 수단을 제공한다 . QDir 의 사용방법 을 알기 위 하여 특정한 등록부와 임의 의 깊 이 
의 모든 보조등록부들에서 모든 화상들에 의해 소비되는 공간을 계산하는 자그마한 콘솔응용 
프로그람을 작성한다 . 

응용프로그람의 핵심부는 imageSpace() 함수로서 주어진 등록부의 크기를 계산한다 . 
int imageSpace(const QString &path) 

{ 

QDir dir(path); 

QStringList: iterator it; 
int size = 0; 

QStringList files = dir.entryList("*.png *.jpg *.jpeg", QDir::Files); 

it = files.begin(); 

while (it != files.end()) { 

size += QFileInfo(path, *it).size(); 

++it; 

} 

QStringList dirs = dir.entryList(QDir: : Dirs); 

it = dirs.begin(); 

while (it != dirs.end()) { 

if (*it != && *it != V，) 

size += imageSpace(path + + *it); 

++it; 
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} 

return size ; 

} 

주어진 경로를 리용하여 QDir 객체를 창조하는것으로 시작한다. entryList () 함수에 2개의 인 
수를 넘긴다. 첫째 인수는 공백으로 구분한 파일이름려과기들의 목록이다. 이것들은 대리기호 
와 7’들을 포함한다. 이 실례에서는 오직 PNG 와 JPEG 파일들만 포함하도록 려과한다. 둘째 
인수는 어 떤 종류의 항목(보통파일，등록부, 구동기 등.)들을 포함하는가 지 정한다. 

파일목록을 순환하면서 그 크기를 루계한다. QFilelnfo 클라스는 파일의 크기, 허가，소유자, 
시간과 갈은 속성들을 호출하게 한다. 

두번째의 entryListO 호출에서 이 등록부의 모든 보조등록부들을 엄고 그것들을 항행하면서 
imageSpace () 을 재귀호출하여 루계화상크기를 확인한다. 

매개 보조등록부의 경로를 창조하기 위해서는 현재등록부의 경로를 사선으로 구분하여 
보조등록부이 름 (* it ) 과 결합한다. QDir 는 V’ 를 모든 가동환경 에서 등록부구분기 호로서, Windows 
에서 는 ’\’를 구분기 호로서 취 급한다. 사용자에게 경 로를 표시할 때 정 적함수 QDir :: 
convertSeparators () 를 호출하여 사선들을 가동환경에 고유한 정확한 구분기호로 변환한다. 

프로그람에 main () 함수를 추가한다. 

int main(int argc , char * argv []) 

{ 

QString path = QDir :: currentDirPath (); 
if (argc > 1) 

path = argv [ l ]; 

cerr « "Space used by images in " « endl 
« path . ascii () « endl 
« ’’and its subdirectories is ’’ 

« ( imageSpace ( path ) / 1024) « ’’ KB " « endl ; 
return 0; 

} 

이 실례에서는 (가의 도구클라스들만 사용하므로 (^Application 객체를 요구하지 않는다. 

QDir :: currentDirPath () 를 사용하여 경로를 현재등록부로 초기화한다. 또한 QDir :: 
homeDirPathO 를 리용하여 경로를 사용자의 홈등록부로 초기화할수 있다. 사용자가 지 령행에 
경로를 지정하면 그대신 그것을 사용한다. 끝으로 imageSpace () 함수에 의하여 화상들이 소비 
한 공간을 계산한다. 

QDir 클라스는 rename (), exists (), mkdir (), rmdir () 를 비롯한 다른 파일들과 등록부관련함수들 
을 제공한다. QFile 클라스는 remove () 와 exists () 를 비롯한 정 적 편의 함수들을 제공한다. 
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제 4 절 프로쎼스사이통신 


QProcess 클라스는 외부프로그람들을 실행하고 교제하게 한다. 이 클라스는 비 
작업하며 사용자대면부가 응답성을 유지하도록 배경에서 자기 작업을 수행한다. 
외 부프로쎄 스가 자료를 가지 거 나 완료했 을 때 통지 하기 위 한 신 호들을 발생 한다. 

외 부화상편의프로그람의 사용자대 면부를 제 공하는 자그마한 응용프로그람을 기 
실례에서는 모든 주요 가동환경들에서 자유로 사용할수 있는 ImageMagick 변환프 i 
용하게 한다. 

穴 ■■■■■■■■■■ 需 ， ■ U X 

Source File: |yhome/hicMmage 아 oad4.png Irow 的 | 

larget Format: | BMP U 


p Options - 

F7 Enhance 

「 Monochrome 




File /homayhicy magesfr oad4 .bmp created 


Convert | Suit 


그림 10-1. Image Converter 응용프로그람 

Image Converter 의 사용자대면부는 Qt Designer 로 창조한다. 여기서는 코드를 포’ 
파일에 초점을 둔다. process 와 fileFilters 변수들은 Qt Designer 의 Members 타브에서 t 
선언되여있다. 


QProcess * process;QString fileFilters ; 
uic 도구는 이 변수들을 ConvertDialog 클라스의 부분으로 포함한다. 
void ConvertDialog :: init () 

{ 

process = 0; 

QStringList imageFormats = Qlmage : : outputFormatList (); 

targetFormatComboBox -> insertStringList ( imageFormats ); 

fileFilters = tr (" Images ") +，’ (*.，，+ imageF ()_ ts . join (" *."). lower () +，，)"; 


파일려 과기는 설명 본문과 하나이상의 대리 기호견본들로 구성 된다. 




files(*.txt)"). QImage::outputFonna 江 ist() 함수는 Qt 가 유지 하는 화상출력형 식 들의 목록을 돌려 준 
다 . 이 목록은 Qt 가 설치될 때 설정된 선택들에 따라 달라질수 있다 . 
void ConvertDialog: : browse() 

{ 

QString initialName = sourceFileEdit->text(); 
if (initialName.isEmptyO) 

initialName = QDir: : homeDirPath(); 

QString fileName = QFileDialog::getOpenFileName(initialName, fileFilters, this); 
fileName = QDir: : convertSeparators(fileName); 
if (! fileName. isEmptyO) { 

sourceFileEdit->setText(fileName); 
convertButton->setEnabled(true); 

} 

} 

대화칸의 Browse 단추는 browse() 처리부에 련결된다 . 사용자가 이미 파일을 선택하였다면 
파일대화칸을 그 파일의 경로로 초기화하고 그렇지 않으면 사용자의 홈등록부를 사용한다 . 
void ConvertDialog::convert() 

{ 

QString sourceFile = sourceFileEdit->text(); 
targetFile = QF ileInfo(sourceF ile). dirPath() + QDir: :separator() + 
QFileInfo(sourceFile).baseName(); 

targetFile += 

targetFile += targetFormatComboBox->currentText().lower(); 
convertButton->setEnabled(false); 
outputTextEdit->clear(); 
process = new QProcess(this); 
process->addArgument("convert"); 
if (enhanceCheckBox->isChecked()) 
process->addArgument("-enhance"); 
if (monochromeCheckBox->isChecked()) 
process->addArgument( n -monochrome n ); 
process->addArgument(sourceFile); 
process->addArgument(targetFile); 

connect(process, SIGNAL(readyReadStderr()), this, SLOT(updateOutputTextEdit())); 
connect(process, SIGNAL(processExited()), this, SLOT(processExited())); 




process->start(); 


} 

대화칸의 Convert 단추는 convertO 처리부에 련결된다 . 원천파일의 이름을 복사하고 목표파 
일형식과 일치하도록 그 뒤붙이를 변경한다 . 

그다음 QProcess 객체를 창조한다 . addArgument() 을 사용하는 QProcess 객체에 주어진 첫째 
인수는 실행하려는 외부프로그람의 이름이다 . 그 뒤의 인수들은 이 프로그람의 인수로 된다 . 

QProcess 의 readyReadStderr() 를 대화칸의 updateOutputTextEdit() 처리 부에 련결하여 오유가 발 
생하였을 때 외부프로그람으로부터 대화칸의 QTextEdit 에 오유통보문들을 현시한다 . 또한 
QProcess 의 precessExited() 신호를 대화칸의 같은 이름의 처리 부에 련결 한다 . 
void ConvertDialog: : updateOutputTextEdit() 

{ 

QByteArray data = process->readStderr(); 

QString text = outputTextEdit->text() + QString(data); 

outputTextEdit->setText(text); 

} 

외부프로쎄스가 stderr 에 써넣을 때마다 updateOutputTextEdit() 처리부가 호출된다 . 그 오유 
본문을 읽어서 QTextEdit 에 추가한다 . 
void ConvertDialog: :processExited() 

{ 

if (process->normalExit()) { 

outputTextEdit->append(tr("File %1 created") .arg(targetFile)); 

} else { 

outputTextEdit- 〉 append ( 仕 (’’Conversion failed")); 

} 

delete process; 

process = 0; 

convertButton->setEnabled(true); 

} 

프로쎄스가 완료되 였을 때 사용자에게 결과를 알리고 프로쎄스를 삭제한다 . 

이와 같이 콘솔응용프로그람을 포함하는 방법은 현존기능을 다시 실현하지 않고 그 기능 
자체를 사용하게 하므로 더 효과적이다 . QProcess 의 다른 사용은 웨브열람기나 email 의뢰기와 
갈은 다른 GUI 응용프로그람들을 호출하는것 이다 . 



제 11 장. 용기클라스 


용기 클라스는 주어 진 형 의 항목들을 기 억 기 에 보관하는 일 반목적 형 판클라스이 다 . 표준 
C++ 는 이 미 표준형판서 고 (STL) 의 일부로서 많은 용기 들을 포함하고있다 . 

(가는 자체 의 용기클라스들을 제 공하므로 Qt 프로그람을 쓸 때 (가와 STL 의 용기 를 둘다 사 
용할수 있다 . 자기 가 이 미 STL 용기 에 습관되 여있고 자기의 목표가동환경 에 유효한 STL 이 있 
으면 Qt 용기를 리용할 특별한 리유란 없다 . 

이 장에서는 대부분의 중요한 STL 과 Qt 용기들을 개괄한다 . 또한 QString 과 QVariant 를 고 
찰한다 . 두 클라스들은 용기들과 공통점이 많고 일부 상황에서는 용기대신에 사용할수 있다 . 

제1절. 백토르 

백토르 , 목록，매프용 STL 과 Qt 클라스들은 보관하려는 객체들의 형의 따라 파라메터화된 
형판클라스들이다 . 이 클라스들에 보관할수 있는 값들은 기본형 (int 와 double), 지적자，혹은 기 
정 구성 자(인수없는 구성 자)，복사구성 자，대 입연산자를 가지 는 클라스일수 있다 . 수식 하는 클 
라스들에는 QDateTime, QRegExp, QString, QVariant 들이 포함된다 . QObject 를 계승하는 Qt 클라스 
들은 수식 하지 않는다 . 그것은 이 클라스들이 복사구성 자와 대 입연산자를 실현하지 않기때문 
이다 . 이것은 보통 문제가 아니므로 여전히 이려한 형들에 지적자들을 보관할수 있다 . 

이 절에서는 벡토르에 대한 가장 일반적인 조작들을 고찰하고 다음의 두개 절에서는 목 
록과 매프를 개괄한다 . 대부분의 실례들에서는 영화제목과 재생시간을 보관하는 Film 클라스를 
사용한다 . (동화상을 표시하는데 쓰이는 여의 QMovie 클라스와 너무나도 비슷하므로 Movie 클 
라스라고 부르지 않는다 .) 

여기에 Film 의 정의가 있다 . 
class Film 
{ 

public: 

Film(int id = 0, const QString &title = … int duration = 0); 

int id() const { return myld;} 

void setld(int catalogld) { myld = catalogld;} 

QString title() const { return myTitle;} 
void setTitle(const QString &title) { myTitle = title;} 
int duration() const { return myDuration;} 
void setDuration(int minutes) { myDuration = minutes;} 
private: 
int myld; 

QString myTitle; 
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int myDuration; 


}； 

int operator==(const Film &filml, const Film &film2); 
int operator<(const Film &filml, const Film &film2); 

C++ 가 자동적으로 제공하는것 이 면 충분하므로 복사구성자나 대 입연산자를 명시적으로 제 
공하지 않는다 . 클라스가 그 클라스에 의해 할당된 기억기의 지적자들을 포함한다면 자체로 
지적자들을 실현해야 한다 . 

클라스와 함께 같기연산자와 작기연산자를 제공한다 . 같기연산자는 용기에 특정한 항목이 
있는가 탐색할 때 쓰인다 . 작기연산자는 항목들을 정 렬하기 위하여 비교하는데 쓰인다 . 4 개의 
다른 비교연산자들(!=,<>%'%；:’：>=)은 STL 이 절대로 사용하지 않으므로 실현할 필요가 없다 . 
여기에 3 개의 비 inline 함수들의 실현이 있다 . 

Film::Film(int id, const QString &title, int duration) 

{ 

myld = id; 
myTitle = title; 
myDuration = duration; 

} 

int operator==(const Film &filml, const Film &film2) 

{ 

return filml .id() == film2.id(); 

} 

int operator<(const Film &filml, const Film &film2) 

{ 

return filml.id() < film2.id(); 

} 

Film 객체들을 비교할 때 제목들이 절대로 유일하지 않으므로 제목보다 ID 들을 사용한다 . 

films[0] 
films 【 1 】 
films[2] 
films[3] 
films[4] 


1 


Fi_12 "A Hard Day s NigW, 期 ) 

Film(5051 "Seven Days to Noon". 94> 1 

F#m0301 "Day of Wrath", 105) 

Film(9227 "A Special Day", 110) 

F_1817 "Day Ibr Night”. 116} 



그림 11-1. Film 들의 벡 토르 




벡토르는 기억기의 이웃위치들에 항목들을 보관하는 자료구조이다 . 일반 C ++ 배렬과 벡토 
르의 차이는 벡토르는 자기의 크기를 알고있고 크기를 변경할수 있다는것이다 . 벡토르의 끝 
에 여분의 요소들을 추가하는것은 아주 효과있으나 벡토르의 앞이나 중간에 요소들을 삽입하 
는것은 품이 든다 . 

STL 의 vector 클라스는 std::vector<T > 이고 <vector ： ^l 서 정의된다 . 여기에 실례가 있다 . 
vector<Film> films; 

방에서 벡토르는 QValueVector<T> 이다 . 

Q Value Vector<F ilm> films; 

이렇게 창조한 벡토르는 크기가 0 이다 . 몇개의 요소가 필요한가를 미리 알고있으면 벡토 
르를 정의할 때 초기값을 줄수 있고 [] 연산자를 리용하여 요소들에 값을 대입하며 그렇지 않 
으면 후에 크기를 조절하거나 항목들을 추가해야 한다 . 

백토르를 채우는 편리한 수법 은 p US h_backO 를 사용하는것 이 다 . 이 함수는 백토르를 하나 
씩 확장하면서 끝에 요소를 하나씩 추가한다 . 

films.push_back(Film(48 12, ’’A Hard Day’s Night", 85)); 
films.push_back(Film(5051, "Seven Days to Noon", 94)); 
films.push_back(Film(l301, "Day of Wrath", 105)); 
films.push_back(Film(9227, ’’A Special Day", 110)); 
films.push_back(Film( 1817, "Day for Night", 116)); 

일반적으로 Qt 는 STL 과 갈은 함수이름들을 제공하지만 일부 경우에 어는 Qt 풍의 이름들 
을 추가적으로 가진다 . 례를 들면 Qt 클라스들을 사용하면 push_back () 나 append () 를 리용하여 
항목들을 추가할수 있다 . 

백토르를 채우는 다른 방법은 벡토르에 초기크기를 주고 요소들을 개별적으로 초기화하 
는것 이 다 . 

vector<Film> films(5); 

films[0] = Film(4812, "A Hard Day's Night", 85); 
films[l] = Film(5051, "Seven Days to Noon，，, 94); 
films[2] = Film(1301, "Day of Wrath", 105); 
films[3] = Film(9227, "A Special Day，，, 110); 
films[4] = Film(1817, "Day for Night", 116); 

명시적인 값을 주지 않고 창조한 벡토르항목들은 항목클라스의 기정구성자에 의해 초기 
화된다 . 기본형과 지적자형들에 대하여 마치도 탄창에 이려한 형의 변수들을 정의할 때처럼 
값이 정의되지 않는다 . 

□연산자를 리용하여 벡토르의 요소들을 순환할수 있다 . 
for (int i = 0;i < (int)films.size();++i) 
cerr « films[i].title().ascii() « endl; 













또한 반복자를 사용할수 있다 . 


vector<Film>: :const_iterator it = films.begin(); 
while (it != films.end()) { 

cerr « (*it).title().ascii() « endl; 

++it; 

} 

매개 용기클라스는 2 개의 반복자형 iterator 와 const_iterator 를 가지고있다. 두 반복자사이의 
차이 는 const_iterator 가 자료를 수정 할수 없게 한다는것 이 다. 

용기의 beginO 함수는 용기의 첫 항목(례를 들면 films [이)을 참고하는 반복자를 돌려준다. 
용기의 end() 함수는 마지막에서 하나 전 항목(례를 들면， films [5]) 을 참고하는 반복자를 돌려준 
다. 용기 가 비 였으면 beginO 은 endO 와 같다. 이것은 용기가 어떤 요소를 가지는가 확인하는데 
쓰일수 있다. 물론 이러한 목적에는 empty 。 를 호출하는것이 더 편리하다. 

반복자는 C 나지적 자와 비 슷한 문법 을 따른다 . ++와 -연산자들을 사용하여 다음 항목이 나 
이전 항목으로 이동할수 있고 단항*연산자를 리용하여 현재반복자위치에 보관된 항목을 엄을 
수 있다 . 사실상 vector<T> 에서 iterator 와 const_iterator 형들은 순수 T *와 const T * 의 형 정의 이 
다 . 

선 형탐색 으로 벡 토르의 항목을 찾으러 고 한다면 STLfmdO 함수를 사용할수 있다. 
vector<Film> :: iterator it = find(films.begin(), films.end(), Film(4812)); 
if (it != films.end()) 
films.erase(it); 

findO 함수는 마지막 인수로서 넘긴 항목과 같은(연산자 ==() 리용) 첫 항목에로의 반복자를 
돌려준다. 이것은 <algorithm> 에서 다른 많은 형판함수들과 함께 정의된다. 이 함수들은 일반 
적 으로 반복자들에 대 하여 조작한다. Qt 는 각이한 이 름들(례 를 들면 qFindO) 을 가지 는 함수들 
을 일부 제공한다. STL 없이 Qt 를 사용하려고 한다면 이려한 함수들을 사용할수 있다. 

벡토르에서 항목들을 정렬하기 위하여 sort () 를 호출할수 있다. 
sort(films.begin(), films.end()); 

sort 。 함수는 다른 비교함수가 넘어 오지 않으면 <연산자를 사용하여 항목들을 비 교한다. 

정렬되면 binary_search(} 함수에 의하여 항목이 존재하는가 확인한다. 정렬된 벡토르에서 
binary_ S earchO 는 fmdO 와 갈은 결과를 주지만 (2 개의 영화가 갈은 ID 를 가지지 않는다고 가정) 
훨씬 빠르다. 

int id = 1817; 

if (binary_search(films.begin(), films.end(), Film(id))) 
cerr « "Found" «id « endl; 

반복자가 가리키는 위치가 주어지면 품을 들여 insertO 를 리용하여 새로운 항목을 삽입하 
거나 erase() 에 의해 현존항목을 삭제할수 있다. 



films.erase(it); 

벡토르에서 삭제된 항목뒤에 오는 항목들은 그때 왼쪽으로 한 위치 이동되여 그 위치를 
채우고 벡토르의 크기는 하나 줄어든다 . 


제2절. 목록 

목록(혹은 련결목록)은 기억기의 이웃하지 않은 위치들에 항목들을 보관하는 자료구조이 
다 . 백토르와 달리 목록은 아주 빈약한 직접호출기능을 가지며 다른 한편 삽입과 삭제는 아 
주 빠르다 . 

벡토르에서 동작하는 대부분의 알고리듬(특히 sort() 와 binary_search()) 은 목록에서 동작하 
지 않는다 . 이것은 목록이 고속직접호출을 제공하지 않기때문이다 . STL 목록을 정렬하는데 
sort() 성원함수를 리용한다 . 


Film(4ai 2, "A Hard Day's Night". 85) 

1 

Film(5051. "Seven Days to Noon". 94) 


Film(1301 t "DayofWrathM05) 

1 — 
Fi_9227. "A Special Day., 110) 

1 

Fib 며 1817. "Day for Night”. 11 6》 


films.beginO 


f jlrns.endO 


그림 11-2. Film 들의 목록 

STL 의 목록클라스는 std :: list<T> 이고 <list> 에서 정의된다 . 여기에 실례가 있다 . 
list<Film> films; 

어에서 목록은 QValueList<T> 이다 . 

QYalueList<Film> films; 

Film 클라스는 앞절에서 제시하였다 . 

새 항목들은 push_back() 나 insert(H 의해 추가된다 . 백 토르와 달리 목록의 선 두나 중간에 
서 삽입은 품이 들지 않는다 . 

STL 목록은 [] 연산자를 제공하지 않으므로 요소들을 항행하는데 반복자를 사용해야 한다 . 
(Qt 목록은 [] 연산자를 유지하지만 큰 목록에서 아주 느릴수 있다 .) 문법과 사용법은 백토르와 
같은데 반복자형의 앞에 vector<T> 라고 쓰지 않고 list<T> 라고 쓴다 . 례를 들면 
list<Film>::const_iterator it = films.begin(); 
while (it :!■■= films.end()) { 

cerr « (*it).title().ascii() « endl; 





-H-it; 


또한 목록은 대체로 empty(), size(), erase(), clear()^- 비롯하여 벡토르와 같은 함수들을 제공 
한다 . find () 알고리 듬도 목록에서 사용할수 있다 . 

일 부 Qt 함수들은 (3¥ 산 11 요날 <1 >를 돌려 준다 . 함수의 돌림값에 대 하여 순환하려 면 목록의 
사본을 얻고 사본에 대하여 순환해야 한다 . 례를 들면 다음의 코드는 QSplitter::sizes () 가 돌려 
준 ( 가別 11 요 ^<111 >를 순환하는 정 확한 방법 이 다 . 

QValueList<int> list = splitter->sizes(); 

QValueList<int>::const_iterator it = list.begin(); 

while (it != list.end()) { 
do_something(*it); 

++it; 

} 

다음의 코드는 틀린다 . 

// WRONG 

QValueList<int>::const iterator it = splitter->sizes().begin(); 

while (it != splitter->sizes().end()) { 
do_something(*it); 

++it; 

} 

이 것은 QSplitter :: sizesO 가 호출될 때마다 값에 의해 새로운 돌려 주기때 

문이 다 . 돌림값을 보관하지 않으면 C ++ 는 순환을 시 작하기전 에 자동적 으로 돌림값을 해 체 하 
므로 매 달려있는 반복자를 남기 게 된다 . 또한 매 번 순환할 때마다 QSplitter :: sizes () 가 
splitter->sizes().end () 호출로 인하여 목록의 새로운 사본을 생성해야 하는것이다 . 

요약 : 늘 값에 의해 되돌아오는 용기의 사본에 대하여 순환한다 . 

이려한 용기의 복사는 품이 든다고 하지만 그렇지 않다 . 그것은 어가 암시적공유 (implicit 
sharing ) 라는 최적화를 리용하기때문이다 . 이 최적화는 지어는 배경에서 자료복사가 발생하지 
않아도 자료를 복사하는것 처 럼 프로그람을 작성 할수 있다는것 을 의 미한다 . 

(片에서 많이 쓰이는 QStringList 클라스는 QValueList<QS 仕 ing > 의 파생클라스이다 . 이 클라스 
는 그 기초클라스로부터 계승하는 함수들과 함께 클라스를 더 강력하게 하는 여분의 함수들 
을 제공한다 . 이려한 함수들은 이 장의 마지막 절에서 론의한다 . 

제3절. 매프 

매프는 건에 의해 첨수화된 같은 형의 항목들을 임의의 개수 보관한다 . 매프는 건마다 하 
나의 값을 보관한다 . 매프는 우수한 직접호출과 삽입기능을 가전다 . 새 값이 현존 건에 할당 
되면 낡은 값은 새 값으로 교체된다 . 
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films[1301] 
films [1917] 
films [4812] 
filmB 【50511 
films [9227] 


매프가 건-값쌍들을 포함하므로 일반적으로 백토르와 목록의 설계와는 현저히 다른 방법 
으로 매프와 작업하는 자료구조를 설계한다 . 여기에 매프의 사용법을 설명하는데 쓰이는 Film 
클라스의 판이 있다 . 
class Film 
{ 

public: 

Film(const QString &title = int duration = 0); 

Q String title() const { return myTitle;} 
void setTitle(const QString &title) { myTitle = title;} 
int duration() const { return myDuration;} 
void setDuration(int minutes) { myDuration = minutes;} 
private: 

QString myTitle;int myDuration; 

}； 

Film: : Film(const QString &title, int duration) 

{ 

myTitle = title; 
myDuration = duration; 

} 

Film 클라스에서는 일람표正)를 매프의 건으로 사용하므로 그 ID 를 보관하지 않는다 . Film 
에는 비교연산자들이 필요없다 . 매프는 값이 아니라 건에 의하여 순서화된다 . 

STL 의 map 클라스는 std :: map<K ， T > 이고 <map > 에서 정의된다 . 여기 에 건이 int ( 일람표正))이 
고 그 값이 Film 인 매프의 실례가 있다 . 
map<int, Film> films; 

Qt 의 매프는 QMap<K,T> 이다 . 

QMap<int, Film 〉 films; 


1301 

H ᅥ 

| 4812 -»[ 


nmCDayofWrattiMOS) 
FimrDay lor Night", 116) 


Fim("A Hard Day's Night", 85) 


| 505 ， |-»[lam("Seven Days to Noon", & 4) | 
| 9227 | —»| Fim("A Special Day". 110) 


그림 11-3. Film 들의 매 프 
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매프에 항목들을 삽입하는 가장 원시적 인 수법은 주어진 건에 값을 할당하는것이다 . 
films[4812] = Film("A Hard Day’s Night", 85); 
films[5051] = Film( M Seven Days to Noon", 94); 
films[1301] = Film("Day of Wrath", 105); 
films[9227] = Film(’’A Special Day", 110); 
films[1817] = Film("Day for Night", 116); 

매 프반복자는 건-값쌍을 제 공한다 . 건 부분은 (*it).fu*st 에 의 해 값부분은 (*it).second 에 의해 
꺼낸다 . 

map<int, Film> :: const iterator it = films.begin(); 
while (it != films.end()) { 

cerr « (*it).first « ": " « (*it).second.title().ascii() « endl; 

++it; 

} 

또한 대부분의 콤파일러들은 it->first 와 it->second 를 쓸수 있게 하지만 (*it).first 와 (*it).seco 
nd 라고 쓰는것이 더 이식성있다 . 

Qt 매프의 반복자는 STL 매프의 반복자와 현저히 다르다 . Qt 매프에서 건은 it.key() 에 의하여， 
값은 itdataO 에 의하여 반복자로부터 얻어 진다 . 

QMap<int, Film>: :const_iterator it = films.begin(); 
while (it != films.end()) { 

cerr « it.key() « " « it.data().title().ascii() « endl; 

++it; 

} 

매프를 순환할 때 항목들은 늘 건에 의해 순서화된다 . 

□연산자를 삽입과 얻기에 모두 사용할수 있으나 [] 으로 존재하지 않는 건의 값을 얻으러 
고 한다면 새 항목이 주어진 건과 빈 값으로 창조된다 . 우연히 빈 값을 창조하지 않게 하려 
면 fmd() 성원함수에 의하여 항목들을 얻는다 . 

map<int, Film>: : const_iterator it = films.find(1817); 
if (it != films.endO) 

cerr « ’’Found " « (*it).second.title().ascii()« endl; 

이 함수는 건이 매프에 없으면 end() 반복자를 돌려준다 . 

실례에서는 옹근수건을 사용하였으나 다른 형의 건들도 가능하며 한가지 일반적인 선택 
은 QString 건 이 다 . 례 를 들면 

map<QString, QString> actorToNationality; 
actorToNationality[’’Doris Day’’] = "American"; 
actorToNationality["Greta Garbo’’] = "Swedish"; 





같은 건에 대하여 여러개의 값을 보관하려고 한다면 multimap<K, 1 >를 사용할수 있다 . 오 
직 건을 보관해야 한다면 set<K> 혹은 1111 山뇨라 <1 ^>를 사용한다 . (가는 이것과 등가한 클라스들 
을 제공한다 . 

Qt 의 QMap<K, 1 >클라스는 작은 자료모임 을 취 급할 때 특별 히 쓸모있는 추가적 인 편의함 
수들을 가지고있다 . QMap<K, T> :: keys() 와 QMap<K, T> :: values() 는 매프의 건과 값들의 
QValueList 들을 돌려준다 . 


제4절. 지적자에 기초하는 용기 

앞절에서 서술한 STL 용기와 같이 Qt 도 용기클라스들의 추가모임을 제공한다 . 이러한 클 
라스들은 STL 이 C ++ 의 부분으로 되기전인 1990 년대초에 Qt 1.0 용으로 개발되였으므로 자기의 
특수한 문법을 가전다 . 이 클라스들이 객체의 지적자들에 대하여 조작하므로 흔히 지적자에 
기초한 용기로서 참고되며 어와 STL 의 값기초용기들과 대조된다 . Qt 4 에서 지적자에 기초한 
용기들은 호환성으로 하여 계속 사용하게 되겠지만 값에 기초한 용기들에 비하여 널리 사용 
되지 않으리라고 기대한다 . 

지적자에 기초한 클라스들을 새로 쓴 Qt 코드에서 사용하는 주요한 원인은 Qt3 의 일부 중 
요함수들이 거기 에 기초하고있기때문이다 . 이미 3 장에서 응용프로그람의 제 일 웃준위창문부 
품을 순환하는 실례를 보았으며 6 장에서 응용프로그람의 MDI 창문들을 순환하는 다른 실례를 
보았다 . 

지적자에 기초하는 주요한 용기들은 QPtrVector<T>, QP 仕 List<T>, QDict<T>, 

QAsciiDict<T>, QIntDict<T>, 그리 고 QP 仕 Dict<T > 이 다 . 

QRrVector<T> 는 지적자들의 벡토르를 보관한다 . 여기에 5 개의 Film 객체들을 
QPttVector<Film > 에 옮기는 실례가 있다 . 

QPtrVector<Film> films(5); 
films. setAutoDelete (true); 

films.insert(0, new Film(4812, "A Hard Day’s Night", 85)); 
films.insert(l, new Film(5051, "Seven Days to Noon", 94》; 
films.insert(2, new Film(1301, "Day of Wrath", 105)); 
films.insert(3, new Film(9227, "A Special Day", 110)); 
films.insert(4, new Film(1817, "Day for Night", 116)); 

QPtrVector<T > 는 append () 함수를 제공하지 않으므로 벡토르의 크기를 자체로 조절해야 하 
며 항목들을 특정한 첨 수위 치 에 삽입 한다.이 실례 에서 는 일 람표 ID 들을 포함하는 원래의 Film 
클라스를 사용한다 . 

Q t 의 지적자에 기초한 용기들의 한가지 우월한 특성은 《자동삭제》속성이다 . 자동삭제가 
허 용되 면 Qt 는 용기 에 모든 객 체 들을 삽입할 권 한을 가지 며 용기 가 삭제 될 때(혹은 remove() 
나 clear () 가 사용될 때 ;) 객체들을 삭제한다 . 

벡트로에서 항목을 삭제하기 위하여 첨수를 넘기여 removeO 를 호출할수 있다 . 











films.remove(2); 

remove () 조작은 벡토르의 크기를 변경하지 않으며 그대신에 항목은 null 지적자로 설정된다 . 
자동삭제가 허용되면 항목은 자동적으로 삭제된다 . 

디 1 방 ¥ £ 야 01<1 >를 항행하기 위하여서는 단순히 첨수를 사용할수 있다 . 
for (int i = 0;i < (int)films.count();++i) { 
if (films[i]) 

cerr « films[i]->title().ascii() « endl; 

} 

주어 진 첨 수의 지 적 자를 사용하기 전 에 그것 이 null 이 아닌 가 검 사하며 그러한 경 우에 는 
삭제되였거나 거기에 할당된것이 없다 . 

QPtrList<T > 클라스는 지적자들의 목록을 보관한다 . append(), prepend(), 혹은 insert () 를 호출 
하여 QPtrList<T > 에 새 항목들을 추가할수 있다 . 

QPtrList<Film> films; 
films, set AutoDelete(true); 

films.append(new Film(4812, ’’A Hard Day’s Night”, 85)); 
films.append(new Film(5051, M Seven Days to Noon", 94)); 

지적자목록은 firstO, next(), prev() ， last() 와 같은 항행함수들을 호출할 때 갱신되는 《현재》 
항목을 가지고있다 . 목록을 순환하는 한가지 수법은 다음과 같다 . 

Film *film = films.first(); 
while (film) { 

cerr « film->title() .ascii() « endl; 
film = films.next(); 

} 

또한 at () 에 의해 목록을 순환할수도 있다 . 
for (int i = 0; i < (int)films.count(); ++i) 
cerr « films.at(i)->title().ascii() « endl; 

셋째 선택은 QPtrListIterator<T 〉 를 사용하는것이다 . 

QDict<T>, QAsciiDict<T>, QIntDict<T>, QPtrDict<T > 클라스들은 map<K, 1 >와 제 일 가까운 지 
적자에 기초한 클라스들이다 . 이러한 클라스들은 또한 건-값쌍들에도 조작한다 . 건은 4 개 클 
라스들중 어 느것 을 사용하는가에 따라서 4 개 의 다른 형 (QString, const char * ， int, 혹은 void *) 중 
하나일수 있다 .4 개 클라스 모두가 같은 함수들을 제공하므로 QIntDict<T > 를 고찰한다 . 

이 클라스를 사용하여 처음에 map<K, T > 에서 사용한것과 같은 형의 Film 들을，일람표正 ) 
를 건으로 리용하여 보관한다 . 

QIntDict<Film> films(lOl); 
films.setAutoDelete(true); 



QIntDict<T > 구성자는 수를 받아들인다 . 그 수는 자료를 넣는 용기가 몇개인가를 결정하기 
위하여 클라스가 내적으로 사용한다 . 성능을 높이기 위하여 그 수는 보관하려는 항목수보다 
좀 큰 씨수로 되여야 한다 . 

새 로운 항목들은 건과 값을 받아들이 는 insertO 로 삽입한다 . 
films.insert(4812, new Film("A Hard Day's Night", 85)); 
films.insert(5051, new Film("Seven Days to Noon", 94)); 

fmd () 나 □연산자에 의하여 항목들을 엄고 remove () 에 의하여 항목을 삭제하며 replace () 로 
주어 진 건과 련상된 값을 교체 한다 . 

같은 건으로 insertO 를 여러번 호출하면 오직 제일 최근에 삽입된 항목을 호출할수 있다 . 
removeO 를 호출하면 항목들은 그것들이 삽입된 순서와는 반대로 삭제된다 . 같은 건에 대하여 
여 러값을 넣는것을 피하기 위하여 insertO 대신에 replace 를 사용할수 있다 . 

반복자를 사용하여 용기전체를 횡단할수 있다 . 

QIntDictIterator<Film> it(films); 
while (it.current()) { 

cerr « it.currentKey() « ": ’’ « it.current()->title().ascii() « endl; 

++it; 

} 

반복자는 currentKey () 로 현재건을， current () 로 현재값을 제공한다 . 항목들이 나타나는 순서 
는 정의되지 않는다 . 

(가는 벡토르류의 특수한 클라스 QMemArray<T > 를 제공하는데 이것은 int 와 double 과 같은 
기본형의 항목들이나 기본형들의 구조체들을 보관한다 . 일부 응용프로그람들은 그것을 직접 
사용하지만 두 파생클라스 QByteArray(QMemArray<char >) 와 QPointArray(QMemArray<QPoint>) 
는 아주 일반적이며 앞 장들에서 여러번 사용하였다 . 

례를 들면 여기에 QByteArray 를 창조하는 방법이 있다 . 

QByteArray bytes(4); 
bytes [이 컴 ， A， ; 
bytes[l] = ， C，; 
bytes[2] = ， D， ; 
bytes[3] = ， C，; 

QMemArray<T > 를 창조할 때 거기에 초기크기를 넘기거나 후에 resize () 를 호출할수 있다 . 
그다음 [] 연산자에 의하여 배렬항목들을 호출할수 있다 . 
for (int i = 0; i < (int)bytes.size(); ++i) 
cerr « bytes[i] « endl; 

QMemArray<T> :: fmd()^r 사용하여 항목을 탐색 할수 있다 . 
if(bytes.find( ， A，) != -1| 




cerr « "Found" « endl; 

QMemArray<T > 와 그 파생클라스들에서 포착하기 어려운 결함은 그것들이 명시적공유 
(explicitly sharing ) 로 되는것 이 다 . 이것은 클라스의 복사구성자나 대 입 연산자를 리용하여 객체 
의 사본을 창조할 때 원 본과 사본이 둘다 갈은 자료를 공유한다는것 을 의 미한다 . 그것 들중 
하나를 수정할 때 다른것도 수정된다 . 명시적공유를 이러한 문제를 가지지 않는 암시적공유 
와 혼돈하지 말아야 한다 . 

리용하여 프로그람을 짤 때 그 수법은 copy () 를 호출하여 그것을 복사 
할 때 깊은 복사를 하게 하는것이다 . 
duplicate = bytes.copy(); 

이것은 2 개의 QMemArray<T > 객체들이 같은 자료를 지적하지 않는다는것을 담보한다 . 

명시적공유에 내재하는 문제들을 피하기 위하여 Qt4 에서는 아마 QMemArray<T > 클라스대 
신에 (3\%1\«\^1 ： 01<1 '>를 사용하게 될것이다 . 그때 QByteArray 와 QPointArray 클라스는 기초클 
라스로서 (3¥크1; 1 以0；加<1'>를 사용할것이다 . 

제5절. QString 과 QVariant 

문자렬은 모든 GUI 프로그람의 사용자대면 부뿐아니 라 자료구조로서도 사용된다 . 

C ++ 는 본래 두 종류의 문자렬 즉 전통적인 C 형식의 '\0 ’완료문자배렬과 string 클라스를 
제공한다 . Qt 의 QStting 클라스는 이것들보다 더 강력하다 . QS 仕 ing 클라스는 16bit 유니코드값들 
을 보관한다 . 유니코드는 ASCII 와 Latin-1 을 부분모임으로 포함하며 보통의 수값들로 이루어 
진다 . 그러 나 QStting 이 16bit 이므로 세계의 대부분의 언어를 쓰기 위한 수천개의 각이한 문자 
들을 표시할수 있다.(유니 코드에 대 한 자세 한 정 보를 알려 면 15 장을 참고하시 오 .；) 

QString 은 2 개의 문자렬을 결합하는 2 항 +연산자와 한 문자렬을 다른 문자렬에 추가하는 
_연산자를 제공한다 . 여기에 실례가 있다 . 

QString str^"User: 
str += userName + "\n"; 

또한 갈은 일을 +=연산자로 수행하는 QStri n g :: append () 함수도 있다 . 
s 仕 =« *pser: ，，; 
str.append(userName); 
str.append("\n ")； 

문자별들을 결합하는 완전히 다른 수법은 QString 의 sprint ^ 함수를 사용하는것이다 . 
str.sprintf("%s %.lf%%"，"perfect competition", 100.0); 

이 함수는 C ++ 서고의 sprints 함수와 갈은 서식지정자를 유지한다 . 우의 실례 에서 str 는 
"perfect competition 100.0 %"로 된 다 . 

문자별들이나 수값들로부터 문자렬을 건설하는 또 다른 수법은 argO 를 사용하는것이다 . 

加 = QString("%l %2 (%3s-%4s)") .arg("permissive") ,arg("society") .arg(1950) ,arg(1970); 

이 실례에서 ”%1 "은 "permissive ， ，로， "%2 " 는 "society” 로 , ，， %3 ” 은 ”1950" 으로 , ，， %4 ，，는 "1970" 



으로 교체된다. 결과는 "permissive society (1950sl970s)" 이다. 여러가지 자료형들을 처리하기 위 
한 arg() 다중정의가 있다. 일부 다중정의는 마당폭，밑수 혹은 류점수의 정확도를 조종하기 위 
한 여분의 파라메터를 가지고있다. 일반적으로 argO 는 형 안전하고 유니코드를 완전유지하므로 
sprintfO 보다 더 좋은 수법이며 번 역기들이 "%n" 파라메터들의 순서를 변경하게 한다. 

QString 은 QString ::num ber() 정 적함수에 의 하여 수값을 문자렬로 변환할수 있다. 
s 仕 = QS 仕 ing::number(59.6); 

혹은 setNumO 함수를 리용할수 있다. 
str.setNum(59.6); 

문자렬로부터 수값에 로의 역변환은 toInt(), toLongLong(), toDouble() 등에 의해 수행 된다. 
례를 들면 

bool ok; 

double d = str.toDouble(&ok); 

이 함수들은 또한 bool 에로의 선택지적자를 받아들이고 변환의 성공여부에 따라 bool 을 
true 나 false 로 설 정한다. 변환이 실폐 할 때 이 함수들은 늘 0 을 돌려 준다. 

문자렬이 있으면 흔히 그 일부를 꺼내려고 한다. midO 함수는 주어진 위치로부터 시작하여 
주어진 길이를 가지는 부분문자렬을 돌려준다. 례를 들면 다음의 코드는 콘솔에 "pays” 를 출 
력 한다. 


QString str = "polluter pays principle"; 
cerr « str.mid(9, 4).ascii() « endl; 

둘째 인수를 생략하면(혹은 -1 을 넘기면) mid() 는 주어진 위치로부터 시작하여 문자렬의 
끝에서 끝나는 부분문자렬을 돌려준다. 례를 들면 다음의 코드는 콘솔에 "pays principle” 를 출 
력 한다. 


QString str = "polluter pays principle"; 
cerr « str.mid(9).ascii() « endl; 

또한 비슷한 일을 하는 leftO 와 right() 함수도 있다. 둘다 문자수 «을 받아들이고 문자렬의 
처 음 혹은 마지 막 «문자를 돌려 준다. 례를 들면 다음의 코드는 콘솔에 "polluter principle" 을 출 
력 한다. 


QString str = "polluter pays principle"; 

cerr « str.left(8).ascii() « " " « str.right(9).ascii() « endl; 

문자렬이 무엇으로 시작하고 끝나는가를 검사하려고 한다면 stertsWkh() 와 endsWith() 함수 
들을 사용할수 있다. 


if (uri.startsWi 仕 i(’’http:’’) && uri.endsWi 仕 i(’’.png")) 


이것은 둘다 다음것보다 간단하고 빠르다. 

if (uri.left(5): 自무 "http:" && uri.right(4) «#= ".png") 



== 연산자에 의한 문자렬비교는 대소문자를 구별한다. 대소문자를 구별하지 않는 비교인 
경우에는 upper () 나 lower () 를 사용할수 있다. 례를 들면 
if ( fileName . lower () =，’ readme . txt ，，) ... 

문자렬의 일정한 부분을 다른 문자렬로 교체하려 고 한다면 replace 를 사용할수 있다. 
QString str = "a sunny day ”; 
str . replace (2, 5, ’’ cloudy "); 

결과는 "a cloudy day " 이다. 코드는 remove () 와 insert () 를 사용하여 다시 쓸수 있다. 
str . remove (2, 5); 
str . insert (2, " cloudy ”); 

우선 위치 2로부터 시작하여 5개 문자를 삭제하여 결과문자렬 "a day "(2 개의 공백)을 얻 
은 다음 위치 2에 ’’ cloudy ” 를 삽입한다. 

첫 인수의 모든 출현을 둘째 인수로 교체하는 replaceO 의 다중정의판이 있다. 례를 들면 
여기에 문자렬에서 의 모든 출현을 ’’& amp ’’ 로 교체하는 방법이 있다. 

str . replace ( n & M , M & amp ; n ); 

한가지 빈번히 제기되는 요구는 문자멸에서 공백(공백기호，타브，새행 등)을 제거하는것 
이 다. QString 은 문자렬의 량 끝으로부터 공백을 제거하는 함수를 가지고있다. 

QString str = ” BOB \t THE \nDOG \ n "; 
cerr « str . stripWhiteSpace (). ascii () « endl ; 

문자렬 str 는 다음과 같이 표시된다. 

I I I IBI 이 Bl l\tl ITIHIEI I |\n|D| 이 Gl |\n| 

stripWhiteSpaceO 가 돌려준 문자렬은 다음과 같다. 

데이 Bl |\t| ITIHIEI I |\n|D| 이레 

사용자입력을 처리할 때 흔히 공백을 제거하는것과 함께 하나이상의 내부공백문자의 모 
든 렬을 하나의 공간으로 교체하려고 할수도 있다. 이것은 simplifyWhiteSpace () 함수가 수행한 
다. 


QString str = " BOB \t THE \nDOG \ n "; 
cerr « str . simplifyWhiteSpace (). ascii () « endl ; 
simplifyWhiteSpace ()°1 돌려준 문자렬은 다음과 같다. 

|B| 이 B| ITIHIEI |미이 G| 

QStringListxsplitO 에 의 하여 문자렬 을 부분문자렬 들로 분리할수 있 다. 

QString str = "polluter pays principle "; 

QS 仕 ingList words = QStringList :: split (" ", str ); 

우의 실례에서는 문자렬 "polluter pays principle " 을 부분문자렬들인 " polluter ", " pays ", 
" principle " 로 분리 한다. split () 함수는 빈 부분문자렬 을 무시 하는가(기 정 ) 무시 하지 않는가를 지 



정 하는 세 번째 의 bool 형 인 수를 가지 고있 다. 

joinO 에 의 해 QStringList 의 요소들을 결 합하여 하나의 문자렬 을 구성 할수 있다. joinQ 의 인 
수는 매개 쌍의 결합문자렬들사이에 삽입된다. 례를 들면 여기에 자모순으로 정렬되고 새행 
으로 구분되 여 QSttingList 안에 포함되 여있는 모든 문자렬들로 이 루어 지 는 하나의 문자렬을 
창조하는 방법이 있다. 

words . sort();s 仕 = words . join ("\ n "); 

문자별들을 취 급할 때 흔히 문자렬 이 비 였는가 비 지 않았는가를 결정해 야 한다. 이 것을 
시험하는 한가지 수법은 isEmptyO 를 호출하는것이며 다른 수법은 length () 가 0인가 검사하는것 
이다. 

QString 은 null 문자렬과 빈 문자렬을 구별한다. 이것은 0 (null 지적자)과 ""(빈문자렬)사이를 
구별하는 C 언어에 뿌리를 두고있다. 문자렬이 null 인가 시험하기 위하여 isNull () 을 호출할수 
있다. 대부분의 응용프로그람들에서 문자렬이 어떤 문자들을 포함하는가 하는 문제가 제기된 
다. isEmptyO 함수는 문자렬 에 문자가 없으면 (null 이 거 나 비 였으면) 仕 ue 를，그렇 지 않으면 false 를 
돌려줌으로써 이려한 정보를 제공한다. 

const char * 문자렬 과 QString 사이 의 변 환은 대 부분의 경 우에 자동이 다. 례 를 들면 
加 +=" (1870)"; 

여기서 형식화없이 const char * 를 QString 에 추가한다. 

일부 상황에서 는 const char *와 QS 仕 ing 사이 의 명시 적 변환이 필요하다. QString 을 const char 
*로 변환하기 위하여서는 ascii () 나 latinlO 을 사용한다. 다른 방법으로 변환하려면 QString 강제 
변환을 사용해야 한다. 

QString 에 대하여 ascii () 나 latinl . f ) 을 호출하거나 const char * 에로의 자동변환이 이 작업을 
수행하게 할 때 돌려주는 분자렬은 QString 객체가 소유한다. 이것은 기억루실에 대하여 걱정 
할 필요가 없다는것을 의미하며 Qt 는 기억기를 반환한다. 다른 한편 지적자를 너무 오래 사 
용하지 말아야 한다. 례를 들면 원래의 QString 을 수정한다면 지적자는 유효라고 담보할수 없 
다. 임의의 시간동안 const char *를 보관해야 한다면 그것을 QByteArray 이나 QCString 형의 변 
수에 대 입할수 있다. 그러 면 자료의 완전한 사본을 보관할수 있다. 

QString 은 암시적으로 공유된다. 이것은 QString 의 복사가 단일지적자의 복사만큼 빠르다 
는것을 의 미한다. 사본들중 하나가 변경 되 면 자료는 실제로 복사되 고 이 것은 배 경 에서 자동 
적으로 처리된다. 이려한 리유로 암시적공유는 흔히 《써넣기할 때 복사하는것》이라고 말한 
다. 

암시적공유의 우점은 최적화이며 프로그람작성자의 개입을 요구하지 않고 간단히 수행된 
다. 

(가는 QBrush , QFont , QPen , QPixmap , QMap < K , T >, QValueList < T >, QValueVectoKT 〉 를 비 롯한 
다른 많은 클라스들에서도 암시적공유를 사용한다. 이것은 이려한 클라스들을 함수파라메터 
토서 그리 고 돌림값으로서 값에 의해 넘 기 는것 이 아주 효과적 이 게 한다. 



C ++ 는 강하게 분류되는 언어이며 이것은 형안전과 효과성을 비롯하여 많은 리득을 제공 
한다. 그러나 일부 상황에서는 일반적으로 자료를 보관할수 있어야 하며 이때 편리한 한가지 
수법은 문자렬을 사용하는것이다. 례를 들면 문자멸은 본문값이나 수값을 문자렬형식으로 보 
관할수 있다. Qt 는 서로 다른 형들을 보관하는 변수를 처리하는 훨씬 더 명백한 수단으로서 
QVariant 를 제공한다. 

QVariant 클라스는 QBrush , QColor , QCursor , QDateTime , QFont , QKeySequence , QPalette , QP 
en , QPixmap , QPoint , QRect , QRegion , QSize , QString 을 비롯한 많은 (가형의 값들을 보관할수 
있다. QVariant 클라스는 또한 용기들 즉 QMap < QString , QVariant >, QStringList , QValueList<QVari 
■다를 보관할수 있다. 4장의 표계산프로그람실현에서 QVariant 를 사용하여 QString , double , 혹 
은 무효값일수 있는 세포의 값을 보관하였다. 

가변형의 한가지 일반적인 사용은 건으로서 문자렬，값으로서 가변형을 사용하는 매프이 
다. 환경구성자료는 보통 QSettings 를 사용하여 보관하고 얻지만 일부 응용프로그람은 이 자료 
를 자료기 지 에 보관하여 직 접 처 리 할수 있다 . QMap < QString ， QVariant > 는 그러 한 상황에서 리 상 
적이다. 


QMap < QString , QVariant 〉 config ; 
config [" Width n ] = 890; 
config [ n Height M ] = 645; 
config [" ForegroundColor n ] = black ; 
config [" BackgroundColor M ] = lightGray ; 
config [" SavedDate ’’] = QDateTime :: currentDateTime (); 

QStringList files ; 

files « n 2003-05. dat M « ，’ 2003-06. dat ，，«，，2003-07. dat " ; 
config [" RecentFiles M ] = files ; 

암시적공유의 작업방법 

암시 적공유는 배경 에서 자동적 으로 작업 하므로 암시 적 공유를 사용하는 클라스들을 사용 
할 때 자기 코드에서 이려한 최적화를 발생시키는 조작을 하지 말아야 한다. 그러나 동작을 
아는것이 좋으므로 하나의 실례를 고찰하여 배경에서 무엇이 발생하는가를 보려고 한다. 
QString strips " Humpty "; 

QString str 2 = strl ; 

s 仕 1 에 " Humpty " 을 설정 하고 s 仕 2 을 s 仕1과 같게 설정한다. 이 시 점 에서 두개의 QString 이 
기억기의 갈은 자료구조 ( QSttingData 형)를 가리킨다. 문자자료에 대하여 자료구조는 같은 자 
료구조를 가리키는 QString 이 몇개인가를 나타내는 참고계수를 보관한다. 加1와 stt 2 이 둘다 
같은 자료를 가리키 므로 참고계 수는 2이 다. 

加2[0] = ' D '; 

s 仕2을 수정할 때 우선 자료의 깊 은 사본을 만들고 s 仕1와 s 仕2이 다른 자료구조를 가리키 




도록 하여 자료가 자기 사본을 변경하도록 한다. strl 자료 (" Humpty ") 의 참고계수는 1로 되고 
s 仕2자료 (" Dumpty ") 의 참고계수는 1로 설정된다. 참고계수1은 자료가 공유되지 않는다는것을 
의 미 한다. 

str 2. truncate (4); 

다시 str 2 을 수정하면 str 2 자료의 참고계수가 1로 되므로 복사가 생기지 않는다. truncate () 
함수는 s 仕2의 자료에 직접 조작하며 결과 문자렬 '’ Dump ’’ 이 생긴다. 참고계수는 여전히 1이 
다. 

s 仕 1 = s 仕 2; 

s 仕2을 加1에 대입할 때 加1자료의 참고계수는 0으로 줄어든다. 이것은 " Humpty " 자료를 
사용하고있는 QS 仕 ing 이 없다는것을 의미한다. 그다음 자료는 기 억기로부터 해방된다. 두 
QString 은 현재 ’’ Dump ” 를 가리키고 현재 참고계수는 2이다. 

암시적으로 공유되는 클라스들을 쓰는것은 그리 어렵지 않다. 

가변 값들을 보관하는 매 프를 순환하는것 은 일부 값들이 용기 이라면 아주 까다로울수 있 
다 . t 刀) e () 를 사용하여 가변값을 보관하는 형을 검사함으로써 적당히 응답할수 있다. 
QMap < QString , QVariant > :: const_iterator it = config . begin (); 
while (it != config . end ()) { 

QString str ; 

if ( it . data (). type () == QVariant::S 仕 ingList ) 
s 仕 = it . data (). toStringList (). join (", "); 
else s 仕 = it . data().toS 仕 ing (); 

cerr « it . key (). ascii () « ": " « str . ascii () « endl ; 

++ it ; 

} 

용기형의 값들을 보관함으로써 QVariant 을 사용하는 임의의 복합자료구조를 창조할수 있 
다. 

QMap<QS 仕 ing , QVariant > price ; 
price [" Orange "] = 2.10; 
price [" Pear "]. asMap ()[" Standard "] = 1.95; 
price [" Pear "]. asMap ()[" Organic "] i ^2.25; 
price [" Pineapple "] = 3.85; 

여기서는 문자렬건(제품명)과 류점수(가격) 혹은 매프로 된 값들을 가지는 매프를 창조하 
였다. 제일웃준위매프는 3개의 건 " Orange ", " Pear ", ’’ Pineapple " 을 포함한다. " Pear " 건과 련상된 
값은 두개 건 (" Standard " 과 ’’ Organic ”) 을 포함하는 매프이다. 

이러한 자료구조의 창조는 자기가 좋아하는 수법으로 자료구조를 만들수 있으므로 아주 
매혹적 일수 있다. 그러 나 QVariant 의 관례는 큰 비 용을 요구한다. 읽 기 편리 하게 보통 적 당한 
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C ++ 클라스를 정의하여 자료를 보관하는것이 좋다. 사용자정의클라스는 형안전을 제공하고 또 
한 QVariant 보다 더 빠르고 기억기사용에서 효과적이다. 



제 12 장. 자료기지 


Qt 의 SQL 모듈은 SQL 자료기 지 들을 호출하기 위한 가동환경 및 자료기 지 에 의 존하지 않는 
대 면부와 자료기 지 들을 사용자대 면부에 통합하기 위한 클라스들의 모임 을 제 공한다. 

이 장에서는 우선 자료기지련결을 여는 방법과 자료기지에 대하여 임의의 SQL 문을 실행 
하는 방법을 보여준다. 2절과 3절에서는 사용자대면부를 통하여 자료기지를 표시하고 수정하 
는 방법 과 QDataTable 에 의 해 표창문부품의 자료를 표시 하는 방법, QSqlForm 에 의 해 폼으로서 
자료를 제시하는 방법을 사용자에게 제공하는데 초점을 둔다. 이 클라스들은 서로 훌륭히 교 
제하도록 설계되여있으며 주-세부보기와 구멍내기와 같은 일반적인 자료기지기능을 만들고 
실현하기 쉽게 한다. 


제1절. 련결과 질문 

SQL 질문을 실행하려 면 우선 자료기 지 와의 련결을 확립 해 야 한다. 일반적으로 자료기 지련 
결은 응용프로그람을 기동할 때 호출하는 개별적인 함수에서 설정된다. 례를 들면 
bool createConnection () 

{ 

QSqlDatabase *db = QSqlDatabase :: addDatabase (" QOCI 8"); 

db -> setHostName ( M mozart . konkordia . edu M ); 

db -> setDatabaseName ( M musicdb n ); 

db -> setUserName (" gbatstone n ); 

db -> setPassword( M T 17 aV 44"); 

if (! db -> open ()) { 

db -> lastError (). showMessage (); 
return false ; 

} 

return true ; 

} 

우선 QSqlDatabase :: addDatabase () 를 호출하여 QSqlDatabase 객체를 창조한다. addDa 1: abase () 의 
인수는 Qt 가 자료기 지 호출에 사용해 야 할 자료기 지 구동프로그람을 지 정한다. 이 경 우에 는 
Oracle 을 사용한다. 상업판의 Qt 3.2 에는 다음과 같은 구동프로그람들이 포함되 여있다. 즉 
QODBC 3( ODBC ), QOCI 8( Oracle ), QTDS 7 (Sybase Adaptive Server ), QPSQL 7( PostgreSQL ), 
QMYSQL 3( MySQL ), 그리고 QDB 2 (IBM DB 2). 무료 및 비상업판들은 이것들의 부분모임을 포 
함한다. 

다음으로 자료기 지 주콤퓨터이 름, 자료기 지이 름, 사용자이 름，그리 고 암호를 설정 하고 련결 
을 열려고 시도한다. open () 이 실폐하면 QSqlError :: showMessage () 을 리용하여 오유통보문을 표 



시한다. 

일반적으로 main () 에서 createConnection () 를 호출할수 있다. 

int main(int argc , char * argv []) 

{ 

QApplication app ( argc , argv ); 
if (! createConnection ()) 
return 1; 

return app . exec (); 

} 

일단 련결이 확립되면 QSqlQueiy 을 사용하여 기초하고있는 자료기지가 유지하는 SQL 문 
을 실행할수 있다. 례를 들면 여기 에 SELECT 문의 실행방법 이 있다. 

QSqlQuery query ; 

query . exec("SELECT title , year FROM cd WHERE year >» 1998")； 

exec () 호출후에 질문의 결과모임을 항행할수 있다. 

while ( query . next ()) { 

QString title = query . value (0). toS 仕 ing (); 

int year = query . value ( 1 ). toInt (); 

cerr « title . ascii () « ": " « year « endl ; 

} 

next () 를 한번 호출하여 QSqlQue ^ 가 결과모임의 첫 레코드에 위치하게 한다. next () 의 련 
이은 호출은 끝에 이를 때까지 매번 한 레코드씩 레코드지적자를 전진시킨다. 끝점에서 next () 
는 false 를 돌려 준다. 결과모임 이 비였으면 nextO 의 첫 호출은 false 를 돌려 준다. 

valueO 함수는 마당값을 QVariant 로서 돌려준다. 마당들에는 SELECT 문에서 주어지는 순서 
로 0으로부터 번호가 붙는다. QVariant 클라스는 int 와 QS 仕 ing 을 비롯한 수많은 C ++ 와 Qt 형들 
을 제공한다. 자료기지에 보관할수 있는 각이한 자료형들은 대응하는 C ++ 및 어형들로 변환 
되고 QVariant 들에 보관된다. 례를 들면 VARCHAR 는 QString 으로, DATETIME 은 QDateTime 
으로 표시된다. 

QSqlQuery 는 결 과모임 을 항행 하기 위 한 다른 함수 즉 first (), last (), prev (), seek (), at () 를 제 공 
한다. 이려한 함수들은 편리하지만 일부 자료기지들에서 기억기가 모자란다. 큰 자료모임에 
조작할 때 간단한 최 적 화를 위 하여 exec () 를 호출하기전 에 QSqlQuery :: sefforwardOnly ( true ) 를 
호출할수 있으며 오직 결과모임 을 항행할 때 만 next () 를 사용한다. 

초기에 execO 의 인수로서 SQL 질문을 지정하였으나 곧 실행하는 구성자에 SQL 질문을 직 
접 넘길수 있다. 

QSqlQuery query( n SELECT title , year FROM cd WHERE year 1998")； 




여기에 오유를 검사하고 문제가 발생하는 경우에 QMessageBox 를 펼치는 방법이 있다 . 
if (!query.isActive()) 

query.lastError().showMessage(); 

INSERTS SELECT 처 럼 대체로 실 행하기 쉽 다 . 

QSqlQuery query("INSERT INTO cd (id, artistid, title, year) " 

"VALUES (203, 102, 'Living in America', 2002 )")； 

그다음에 QSqlQuery::numRowsAffected() 는 SQL 문의 영향을 받은 행수(혹은 자료기지가 그 
정보를 제공할수 없으면 -1 ) 를 돌려준다 .. 

많은 레코드를 삽입해야 하거나 값들을 문자렬로 변환하지 않으려면(그리고 값들을 정확 
히 확장하려면 ) prepareO 를 사용하여 대리기호를 포함하는 질문을 지정한 다음 삽입하려는 값 
들을 속박할수 있다 . Qt 는 모든 자료기지에서 Oracle 형식과 ODBC 형식의 대리기호문법을 유지 
한다 . 이때 그 문법 이 유효하면 그대로 리용하고 그렇지 않으면 모의한다 . 여기 에 이 름있는 
대 리 기 호를 가지 는 Oracle 형 식 문법 을 사용하는 실 례 가 있 다 . 

QSqlQuery query(db); 

query.prepare("INSERT INTO cd (id, artistid, title, year) ’’ 

"VALUES (: id, : artistid, : title, : year)"); 

query.bindValue( n :id n ， 203); 

query.bindValue(" : artistid", 102); 

query.bindValue (": title”, QString("Living in America，，)); 

query.bindValue( n :year M , 2002); 

query.exec(); 

여기에 ODBC 형식의 위치대리기호를 리용하는 실례가 있다 . 

QSqlQuery query(db); 

query.prepareC'INSERT INTO cd (id, artistid, title, year) VALUES (?, ?, ?, ?)"); 

query.addBindValue(203); 

query.addBindValue( 102); 

query.addBindValue(QString("Living in America")); 

query.addBindValue(2002); 

query.exec(); 

prepare() 호출후에 bindVahie() 나 addBindValue() 를 호출하여 새 값들을 속박한 다음 다시 
execO 를 호출하여 새 값들로 질문을 실행할수 있다 . 

대리기호는 흔히 2 진자료 혹은 비 ASCII 혹은 비 Latin-1 문자들을 포함하는 문자렬을 지정 
하는데 쓰인다 . 이려한 배경하에서 어는 유니코드를 유지하는 자료기지들에서 유니코드를 사 
용하고 그렇지 않은것들에 대해서는 문자렬을 적당한 부호화로 명백히 변환한다 . 

어는 사용가능한 자료기지들에 대하여 SQL 일괄처리를 유지한다 . 일괄처리를 시작하려면 






자료기 지련결을 표시 하는 QSqlDatabase 객체 에 대하여 transactionQ 을 호출한다 . 일괄처 리 를 완 
료하려면 commitO 혹은 rollback () 를 호출한다 . 례를 들면 여기 에 일괄처 리내 에서 외부열쇠를 
찾고 WSERT 문을 실행하는 방법 이 있다 . 

QSqlDatabase::database()->transaction(); 

QSqlQuery query; 

query.exec("SELECT id FROM artist WHERE name = ’Gluecifer，，，); 

if (query.next()) { 

int artistld = query.value(0).tolnt(); 
query.exec("INSERT INTO cd (id, artistid, title, year) " 

"VALUES (201， ” + QString::number(artistId) + ", 'Riding the Tiger，, 1997)"); 

} 

QSqlDatabase: :database()->commit(); 

QSqlDatabase::database () 함수는 createCoimection () 에서 생성 한 QSqlDatabase 객체의 지 적자를 
돌려준다 . 일괄처리를 기동할수 없으면 QSqlDatabase::transaction () 은 false 를 돌려준다 . 

일 부 자료기 지 들은 일 괄처 리 를 유지 하지 않는다 . 그러 한 경 우에 transaction(), commit(), 
rollback 。 함수들은 아무것도 수행하지 않는다 . 자료기지와 련결된 QSqlDriver 에 대하여 
hasFeatureO 를 리용하여 자료기지가 일괄처리를 유지하는가 시험할수 있다 . 

QSqlDriver * driver = QSqlDatabase: :database()->driver(); 

if (driver->hasFeature(QSqlDriver::Transactions)) ... 

지금까지의 실례들에서는 응용프로그람이 단일 한 자료기지련결을 리용하고있다고 가정하 
였다 . 다중련결을 사용하려고 한다면 addDatabase () 에 둘째인수로서 이름을 넘길수 있다 . 례를 
들면 


QSqlDatabase *db = QSqlDatabase::addDatabase("QPSQL7", ， ’ OTHER"); 

db->setHostName( n satum.mcmanamy.edu M ); 

db->setDatabaseName("starsdb M ); 

db->setUserName( M gilbert"); 

db- 〉 setPassword("ixtapa6"); 

그다음 이름을 넘기여 QSqmatabase 객체의 지적자를 엄을수 있다 . 

QSqlDatabase: : database(): 

QSqlDatabase *db = QSqlDatabase: :database("OTHER n ); 

다른 련결을 리용하여 질문을 실행하려면 QSqlDatabase 객체를 QSqlQuery 구성자에 넘겨야 
한다 . 

QSqlQuery query(db); 

query.exec("SELECT id FROM artist WHERE name =，Mando Diao，，，); 

매개의 련결이 오직 하나의 능동일괄처리만 처리할수 있으므로 다중련결은 한번에 하나 







이상의 일괄처리를 수행하려고 할 때 사용할수 있다 . 다중자료기지련결을 사용한다면 여전히 
하나의 이름없는 련결을 가질수 있으며 QSqlQuery 은 아무것도 지정되지 않으면 그 련결을 사 
용한다 . 

QSqlQuery 외에도 (가는 고급한 클라스로서 QSqlCursor 클라스를 제공한다 . 이 클라스는 
QSqlQuery 를 계승하고 편의함수들을 확장하여 가장 일반적인 SQL 조작 SELECT, INSERT, 
UPDATE, DELETE 를 수행 하는 본래 의 SQL 을 입 력 하는것 을 피 할수 있 다 . 또한 QSqlCursor 는 
QDataTable 을 자료기지에 속박하는 클라스이다 . 여기서는 QSqlCursor 를 설명하고 다음 절에서 
는 자료기 지 를 인식 하는 QTable 의 파생 클라스 QDataTable 을 설 명한다 . 

여기에 QSqlCursor 을 리용하여 SELECT 를 처리하는 실례가 있다 . 

QSqlCursor cursor ( ， ’ cd，，); 

cursor.select("year >= 1998"); 

등가한 QSqlQuery 은 다음과 같다 . 

QSqlQuery query (，’ SELECT id, artistid, title, year FROM cd ，’ "WHERE year >= 1998"); 

결과모임의 항행은 QSqlQuery 에서와 같은데 마당번호대신에 마당이름들을 valueO 에 넘길 
수 있다 . 


while (cursor.next()) { 

QString title = cursor.value( M title n ).toString(); 

int year = cursor.value("year").toInt(); 

cerr « title.ascii() « ": " « year « endl; 

} 

표에 레코드를 삽입하기 위하여 우선 newQSqlRecord 의 지적자를 돌려주는 primelnsertO 를 
호출하여야 한다 . 그다음 설정하려고 하는 QSqlRecord 안의 매개 마당에 대하여 setValueO 를 
호출하고 insertO 를 호출하여 QSqlRecord 의 자료를 자료기지에 삽입한다 . 례를 들면 
QSqlCursor cursor ( ， ’ cd，，); 

QSqlRecord ^buffer = cursor.primeInsert(); 
buffer->setValue("id n , 113); 
buffer->setValue( M artistid M , 224); 
buffer->setValue( M title", "Shanghai My Heart’’); 
buffer->setValue( M year M , 2003); 
cursor.insert(); 

레코드를 갱신하려 면 우선 수정하려는 레코드에 QSqlCursor 를 배치해 야 한다 . (:례를 들면 
selector next () 를 리용한다 .) 그다음 primeUpdate () 를 리용하여 레코드자료의 사본을 포함하는 
QSqlRecord 의 지적자를 얻는다 . 그다음 setValueQ 를 리용하여 변경하려는 마당들을 설정하고 
update () 를 호출하여 이 변경을 자료기지에 써넣는다 . 례를 들면 
QSqlCursor cursor("cd"); 




cursor.select("id = 125’’); 
if (cursor.next()) { 

QSqlRecord ^buffer = cursor.primeUpdate(); 
buffer->setValue( M title M , ’’Melody A.M."); 
buffer->setValue("year n , buffer- 〉 value("year").toInt() +1); 
cursor.update(); 

} 

레코드의 삭제는 갱신과 비숫하지만 더 간단하다 . 

QSqlCursor cursor("cd"); 
cursor.select("id = 128，，); 
if (cursor.next()) { 

cursor.primeDelete(); 

cursor.del(); 

} 

QSqlQuery 과 QSqlCursor 클라스들은 어와 SQL 자료기지사이의 대면부를 제공한다 . 다음의 
2 개 절에서는 GUI 응용프로그람안에서 그 클라스들을 사용하여 사용자가 자료기지에 보관된 
자료를 표시하고 교제하는 방법을 알게 된다 . 

제2절. 표형식의 폼에서 자료의 표시 

QDataTable 클라스는 열람과 편집기능을 가지는 자료기지인식 QTable 창문부품이다 . 이 클라 
스는 QSqlCursor 를 통하여 자료기지와 교제한다 . 여기서는 QDataTable 을 사용하는 2 개의 대화 
칸을 고찰한다 . 다음 절에서 제시하는 QSqlForm 에 기초하는 대화칸와 함께 이 폼들은 CD 
Collection 응용프로그람을 구성 한다 . 

응용프로그람은 다음과 같이 정의된 3 개의 표를 사용한다 . 

CREATE TABLE artist ( id INTEGER PRIMARY KEY, 

name VARCHAR(40) NOT NULL, country VARCHAR(40)); 

CREATE TABLE cd ( id INTEGER PRIMARY KEY, 

artistid INTEGER NOT NULL, title VARCHAR(40) NOT NULL, 

year INTEGER NOT NULL, FOREIGN KEY (artistid) REFERENCES artist); 

CREATE TABLE track ( id INTEGER PRIMARY KEY ， 

cdid INTEGER NOT NULL, number INTEGER NOT NULL, 
title VARCHAR(40) NOT NULL, duration INTEGER NOT NULL, 

FOREIGN KEY (cdid) REFERENCES cd); 

일부 자료기지는 외부열쇠를 제공하지 않는다 . 이려한 자료기지에서는 FOREIGN KEY 부 
들을 삭제해야 한다 . 여전히 실례는 작업하지만 자료기지는 참고완전성을 가지지 않는다 . 





처음에 작성하는 클라스는 사용자가 기사목록을 편집하게 하는 대 
QDataTable 의 상황차림 표를 리용하여 기 사들을 삽입，갱신 , 혹은 삭제 할수 
은 사용자들이 Update 를 찰칵할 때 자료기지 에 적용된다 . 


Narre I Country 



Update | Cancel 


그림 12-2. ArtistForm 대 화칸 
여기에 대화칸의 클라스정의가 있다 . 
class ArtistForm : public QDialog 
{ 

Q_OBJECT 

public: 

ArtistForm(QWidget ^parent = 0, const char *name = 0); 
protected slots: 
void accept(); 
void reject(); 
private slots: 

void primeInsertArtist(QSqlRecord *buffer); 
void beforeInsertArtist(QSqlRecord ^buffer); 


void beforeDeleteArtist(QSqlRecord ^buffer); 




QSqlDatabase *db; 

QDataTable *artistTable; 

QPushButton *updateButton; 

QPushButton *cancelButton; 

}； 

accept() 와 reject() 처 리 부들은 QDialog 로부터 재 정 의 된 다 . 

ArtistForm: : ArtistForm(QWidget *parent, const char *name) : QDialog(parent, name) 

{ 

setCaption(tr("Update Artists'*)); 

db = QSqlDatabase::database( M ARTIST M )； 

db->transaction(); 

QSqlCursor *artistCursor ^ new QSqlCursor("artist", true, db); 
artistTable = new QDataTable(artistCursor, false, this); 
artistTable->addColumn("name n , tr(’’Name")); 
artistTable->addColumn("country M , tr("Country M )); 
artistTable->setAutoDelete(true); 
artistTable->setConfirmDelete(true); 
artistTable->setSorting(true); 
artistTable->refresh(); 

updateButton = new QPushButton(tr( M Update"), this); 

updateButton->setDefault(true); 

cancelButton = new QPushButton(tr( n Cancel n ), this); 

ArtistForai 구성 자에서 는 ARTIST 자료기 지 련결을 리 용하여 일괄처 리 를 시 작한다 . 그다음 자 
료기 지 의 기사표에 QSqlCursor 를 창조하고 그것을 현시할 QDataTable 를 창조한다 . 

QSqlCursor 구성자의 둘째 인수는《자동거주》기발이다 . true 를 넘기 여 QSqlCursor 에 표의 매 
개 마당에 대한 정보를 적재하고 모든 마당들에 조작하게 한다 . 

QDataTable 구성 자의 둘째 인 수도 역 시 자동거 주기 발이 다 . true 이 면 QDataTable 는 자동적 으로 
QSqlCursor 의 결과모임안의 매개 마당용의 렬들을 창조한다 . false 를 넘기고 addColumnO 를 호 
출하여 결과모임의 name 과 country 마당들에 대응하는 2 개 렬을 제공한다 . 

setAutoDelete() 를 호출하여 QSqlCursor 의 소유자를 QDataTable 에 넘기므로 그것을 자체로 
삭제할 필요가 없다 . setConfimiDeleteO 를 호출하여 QDataTable 이 사용자에게 삭제를 확인하게 
하는 통보창을 펼친다 . setSorting(tme) 를 호출하여 사용자가 렬제목우에서 찰칵하여 렬에 따라 
서 표를 정 렬하게 한다 . 끝으로 refreshO 를 호출하여 QDataTable 에 자료기지의 자료를 채운다 . 
또한 Update 와 Cancel 단추를 창조한다 . 

connect(artistTable, SIGNAL(beforeDelete(QSqlRecord *)), this, 



SLOT(beforeDeleteArtist(QSqlRecord *))); 
connect(artistTable, SIGNAL(primeInsert(QSqlRecord *)), this, 

SLOT(primeInsertArtist(QSqlRecord *))); 
connect(artistTable, SIGNAL(beforeInsert(QSqlRecord *)), this, 
SLOT(beforeInsertArtist(QSqlRecord *))); 
connect(updateButton, SIGNAL(clicked()), this, SLOT(accept())); 
connect(cancelButton, SIGNAL(clicked()), this, SLOT(reject())); 

QDataTable 의 3 개 신호를 3 개의 비공개처리부들에 련결한다 . Update 단추를 accept() 에 , 
Cancel 단추를 reject() 에 련결한다 . 

QHBoxLayout *buttonLayout = new QHBoxLayout; 
buttonLayout->addStretch(l); 
buttonLayout->addWidget(updateButton); 
buttonLayout->addWidget(cancelButton); 

QVBoxLayout *mainLayout = new QVBoxLayout(this); 
mainLayout->setMargin( 11); 
mainLayout->setSpacing(6); 
mainLayout->addWidget(artistTable); 
mainLayout->addLayout(buttonLayout); 

} 

끝으로 QPushButton 들을 수평 배 치 관리 자에 넣 고 QDataTable 와 수평배 치 관리 자를 수직배 치 
관리자에 넣는다 . 

void ArtistForm: : accept() 

{ 

db->commit(); 

QDialog::accept(); 

} 

사용자가 Update 를 찰칵하면 일괄처 리를 예 약하고 기초클라스의 accepts 함수를 호출한다 . 
void ArtistForm: : reject() 

{ 

db->rollback(); 

QDialog::reject(); 

} 

사용자가 Cancel 을 찰칵하면 일괄처리를 되돌리고 기초클라스의 reject*} 함수를 호출한다 . 
void ArtistForm::beforeDeleteArtist(QSqlRecord ^buffer) 

{ 
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QSqlQuery query(db); 

query.exec("DELETE FROM track WHERE 仕 ack.id IN (SELECT track.id FROM 仕 ack, " 

" cd WHERE track.cdid = cd.id AND cd.artistid 
+ buffer->value("id").toString() + ")")； 

query.exec("DELETE FROM cd WHERE artistid = " + buffer->value("id").toString()); 

} 

beforeDeleteArtistO 처리 부는 레코드가 삭제 되기 직전에 발생되는 QDataTable 의 
beforeDeleteO 신호에 련결된다. 여기서는 기사에 의하여 CD 들로부터 모든 자리길들을 삭제할 
데 대 한 질 문과 기 사에 의해 모든 CD 들을 삭제 할데 대 한 질 문을 실 행 함으로써 폭포식 (종속 
적인) 삭제를 수행한다. 이려한 삭제는 관계완전성에 위험을 주지 않는다. 그것은 이려한 삭 
제가 폼의 구성자에서 시작되는 일괄처리의 상황에서 모두 수행되기때문이다. 

또 다른 수법은 사용자가 cd 표에 의해 참고되는 기사들을 삭제하지 않도록 하는것이다. 
이것을 달성하려면 QDataTable::contextMenuEvent()l- 재정의하여 삭제를 자체로 처리해야 한다. 
자료기지가 관계완전성을 실시하도록 설정된 경우에 작업하는 초기의 수법은 단순히 삭제를 
시 도하고 자료기 지 에 그것 을 맡기 여 미 연 에 방지 하는것 이 다. 

void ArtistForm :: primelnsertArtist(QSqlRecord *buffer) 

{ 

buffer->setValue("country", "DPRK"); 

} 

primeInsertArtist() 처리 부는 사용자가 새 레코드의 편집을 시작하기 직전에 발생되는 
QDataTable 의 primelnsertO 신호에 련결된다. 이 처리부를 리용하여 새 레코드의 country 마당의 
기정값을 우리 나라에서 사용하는 응용프로그람의 리상적 인 기정값인 "DPRK” 로 설정한다. 

이 것은 마당에 기 정값을 설정 하는 한가지 수법 이 다. 또 하나의 수법 은 QSqlCursor 의 파생 
클라스를 만들고 primelnsertO 를 재정의하는것이다. 이 함수는 갈은 응용프로그람에서 갈은 
QSqlCursor 를 여러번 사용하고 일관한 동작을 담보하려고 하는 경우에 의의를 가전다. 셋째 
수법 은 CREATE TABLE 문의 DEFAULT 절 을 사용하는 자료기 지 준위 에 서 수행 하는것 이 다. 

void ArtistForm: : beforeInsertArtist(QSqlRecord *buffer) 

{ 

buffer->setValue("id", generateld("artist", db)); 

} 

beforelnsertArtistO 처리부는 사용자가 새 레코드의 편집을 완료하고 그것을 보관하기 위하 
여 Enter 를 눌렀을 때 발생되는 QDataTable 의 beforelnsertO 신호에 련결된다. id 마당의 값을 생 
성 된 값으로 설정한다. generateld() 라는 함수에 기초하여 유일한 주열쇠 (primary key) 를 생성한 
다. 

generateldO 를 여 러 번 생성해 야 하므로 머 리부파일 에서 이 함수를 inline 으로 정 의 하고 그 



I 요구될 때마다 포함한다. 여기에 그것을 실현하는 빠른(비효과적인) 수법이 있다. 
inline int generateId(const QString &table, QSqlDatabase *db) 

{ 

QSqlQuery query(db); 

query.exec("SELECT max(id) FROM " + table); 
query.next(); 

return query.value(O) ,toInt() + 1 ； 

} 

generateld() 함수는 대응하는 INSERT 문과 같은 일괄처리의 상황에서 실행된다면 ; 
卜을 담보할수 있다. 

일부 자료기지는 자동생성되는 마당들을 유지한다. 이 마당들과 관련하여 단지 자 J 
id 마당들을 자동생 성한다고 알리 고 QSqlCursor 에 대 하여 setGenerated("id", false) 를 호 1 
■당의 값을 생성하지 않는다고 말한다. 

이제 QDataTable 를 사용하는 다른 대화칸을 고찰한다. 이 대화칸에서는 주-세부보기 
는다. 주(기본)보기는 CD 들의 목록이다. 세부보기는 현재 CD 의 자리길목록이다. 이 t 
:: D Collection 응용프로그람의 기 본창문이 다. 

이번에는 Add, Edit, Delete 단추들을 제공하여 사용자가 상황차림표에 기초하지 않고 
r 수정하게 한다. 사용자들이 Add 혹은 Edit 를 찰칵하면 CdForm 대화칸을 펼친다. (G 












이 실례와 이전 실례사이의 또 하나의 차이는 외부열쇠를 해결하여 기사의 ID 가 아니라 
기사의 이름과 나라를 표시할수 있다는것이다 . 이것을 달성하기 위하여 임의의 SELECT 문(이 
경우에는 결합)들을 유지하는 QSqlCursor 의 파생 클라스인 QSqlSelectCursor 를 사용해야 한다 . 
우선 클라스정의는 다음과 갈다 . 
class MainForm : public QDialog 
{ 

Q_OBJECT 

public: 

MainForm(QWidget ^parent = 0, const char *name = 0); 
private slots: 

void addCd(); 
void editCd(); 
void deleteCd(); 

void currentCdChanged(QSqlRecord ^record); 
private: 

QSplitter * splitter; 

QDataTable *cdTable; 

QDataTable *trackTable; 

QPushButton *addButton; 

QPushButton *quitButton; 

}； 

MainForm 클라스는 QDialog 을 계승한다 . 

MainForm: : MainForm(QWidget ^parent, const char *name) : QDialog(parent, name) 

{ 

setCaption(tr("CD Collection")); 
splitter = new QSplitter(Vertical, this); 

QSqlSelectCursor *cdCursor = new QSqlSelectCursor("SELECT cd.id, title, name, ’’ 
"country, year FROM cd, artist WHERE cd.artistid = artist.id’’); 
if (! cdCursor->isActive()) { 

QMessageBox: : critical(this, tr("CD Collection"),tr("The database has not been created.\n M 
’’Run the cdtables example to create a sample 
"database, then copy cdcollection.dat into ’’ 

"this directory and restart this application.")); 




qApp->quit(); 


} 

cdTable = new QDataTable(cdCursor, false, splitter); 
cdTable- 〉 addCohunn("title" ， tr("CD")) ; 
cdTable->addColumn(”name” ， tr("Artist "))； 
cdTable->addColumn( n country", tr( M Country M )); 
cdTable- 〉 addColumn("year", tr("Year M )); 
cdTable->setAutoDelete(true); 
cdTable->refresh(); 

구성자에서는 cd 표의 읽기전용 QDataTable 과 그와 련관된 유표를 창조한다 . 유표는 cd 표와 
기사표들을 결합하는 질문에 기초하고있다 . QDataTable 은 QSqlSelectCursor 에 조작해야 하므로 
읽 기 전용이 다 . 읽 기 전용표들은 상황차림 표를 제 공한다 . 

유표질문이 실패 하면 통보창을 펼치 고 오유가 발생 하였으며 응용프로그람을 완료한다는 
것 을 표시한다 . 

QSqlCursor *trackCursor = new QSqlCursor("track"); 
trackCursor->setMode(QSqlCursor::ReadOnly); 
trackTable = new QDataTable(trackCursor, false, splitter); 
trackTable->setSort(trackCursor->index( n number")); 
trackTable->addColumn("title M , tr("Track")); 
trackTable->addColumn( M duration M , tr("Duration")); 

둘째 QDataTable 과 그 유표를 창조한다 . 유표에 대하여 setMode(QSqlCursor::ReadOnly) 를 호 
출함으로써 표를 읽기전용으로 만들고 setSortO 를 호출하여 자리길들을 자리길번호에 따라 정 
렬 한다 . 

addButton = new QPushButton(tr("&Add n ), this); 
editButton = new QPushButton(tr("&Edit"), this); 
deleteButton = new QPushButton(tr("&Delete M ), this); 
refreshButton = new QPushButton(tr( M &Refresh n ), this); 
quitButton = new QPushButton(tr("&Quit"), this); 
connect(addButton, SIGNAL(clicked()),this, SLOT(addCd())); 

connect(quitButton, SIGNAL(clicked()) ， this, SLOT(close())); 
connect(cdTable, SIGNAL(currentChanged(QSqlRecord *)),this, 

SLOT(currentCdChanged(QSqlRecord *))); 
connect(cdTable,SIGNAL(doubleClicked(int, int, int, const QPoint &)), this, 

SLOT(editCd())); 







} 

사용자대면부의 나머지부분을 설정하고 필요한 동작을 생성하는데 요구되는 신호-처리부 
련결들을 창조한다. 

void MainForm: : addCd() 

{ 

CdForm form(this); 
if (form.exec()) { 

cdTable->refresh(); 

trackTable->refresh(); 



사용자가 Add 를 찰칵할 때 이 행금지 CdForm 대화칸을 펼치고 사용자가 그우에서 Update 를 
찰칵하면 QDataTable 들을 갱신한다. 
void MainForm: : editCd() 

{ 

QSqlRecord *record = cdTable->currentRecord(); 
if (record) { 

CdForm form(record->value("id").toInt(), this); 
if (form.exec()) { 



} 

} 

} 

사용자가 Edit 를 찰칵하면 CdForm 구성자에 현재 CD 의 ID 를 인수로서 넘기여 이행금지 
CdForm 대화칸을 기동한다. 그러면 대화칸이 펼쳐지고 현재 CD 의 자료들이 들어 있는 마당들이 
표시된다. 

폼을 여기서 수행한 ID 로 파라메터화하면 正)는 폼이 나타날 때 유효로 되지 않는다. 례 
를 들면 어 떤 사용자가 CD 를 삭제 하기전 에 다른 사용자가 Edit 를 잠간 찰칵할수 있 다. 
CdForm 에서 수행할수 있는것은 transactionO 호출후에 즉시 넘기는 正)에 대하여 SELECT 를 실 
행하고 여전히 ID 가 존재한다면 전진하는것이다. 여기서는 단순히 자료기지에 기초하여 무효 
한 ID 를 사용하려는 시도가 있으면 오유를 알리는것이다. 
void MainForm: : deleteCd() 

{ 
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QSqlRecord *record = cdTable->currentRecord(); 

if (record) { 

QSqlQuery query; 

query.exec("DELETE FROM track WHERE cdid S . 與 + record->value("id").toS 仕 ing()) ; 
query.exec("DELETE FROM cd WHERE id =，，+ record->value("id").toString()); 
cdTable->refresh(); 
trackTable->refresh(); 

} 

} 

사용자들이 Delete 를 찰칵할 때 자리 길표에서 현재 CD 의 모든 자리 길들을 삭제 한 다음 cd 
표에서 현재 CD 를 삭제한다 . 그다음 두 표를 갱신한다 . 

void MainForm::currentCdChanged(QSqlRecord *record) 

{ 

trackTable->setFilter("cdid = " + record->value("id").toS 仕 ing()); 

trackTable->refresh(); 

} 

currentCdChangedO 처리부는 cdTable 의 currentChanged () 신호에 련결된다 . 이 신호는 사용자 
가 현재 CD 를 수정하거나 사용자가 다른 CD 를 현재 CD 로 만들려고 할 때 발생된다 . 현재 CD 
가 달라질 때마다 자리길표에 대하여 setFilter () 를 호출하고 현재 CD 와 관련된 자리길들을 현 
시하도록 초기화하고 refresh () 를 호출하여 표에 관련한 자료를 다시 옮기게 한다 . 

이것은 MainForm 을 실현하는데 요구되는 코드의 전부이다 . 한가지 가능한것은 매개 자리 
길의 지 속시 간을 초 (’’155 ”) 가 아니 라 분과 초(례 를 들면 "02:35 ”) 로 나누어 표시할수 있는것 이 
다 . 그러기 위하여 QSqlCursor 의 파생클라스를 만들고 calculateField () 함수를 재정의하여 지속 
시간마당을 요구되는 형식의 QString 으로 변환할수 있다 . 

QVariant TrackSqlCursor::calculateField(const QS 仕 ing &name) 

{ 

if (name = "duration") { 

int duration = value("duration").toInt(); 

return QString("%l :%2").arg(duration / 60 ， 2).arg(duration % 60 ， 2); 

} 

return QVariant(); 

} 

또한 유표에 대하여 setCalculated("duration", ttue) 을 호출하여 QDataTable 에게 단순히 
value () 을 사용하지 않고 지속시간마당에 대하여 calculateFieldO 가 돌려주는 값을 사용한다는것 
을 알린다 . 





제 3 절. 자료인식폼의 창조 

아는 자료기지와 폼들사이의 교제를 혁신하는 수법을 제공한다 . 각 기본창문부품에 대하 
여 제각기 자료기지허용판을 만드는것이 아니라 짯는 자료기지마당들을 창문부품들과 련결하 
는데 QSqlForm 와 QSqlPropertyMap 를 사용하여 임의의 창문부품이 자료를 인식하게 만들수 있 
다 . 기 본창문부품이 나 사용자정 의창문부품은 이 려 한 클라스들을 사용하여 자료를 인식 하게 
만들수 있다 . 

QSqfform 은 폼들을 창조하여 자료기 지안의 개 별적 인 레코드들을 간단히 열 람하거 나 편집 
하게 하는 QObject 의 파생클라스이다 . 일반적 인 사용법은 다음과 같다 . 

① 레 코드의 마당들에 대 응하는 편 집 기 창문부품들 (QLineEdits, QComboBoxes, QSpinBoxes, 
등)을 창조한다 . 

② QSqlCursor 을 창조하고 그것을 편집하려는 레코드로 옳긴다 . 

③ QSqlForm 객 체 를 창조한다 . 

④ QSqlForm 에 게 어 느 편집 기창문부품이 어 느 자료기 지마당에 결합되 는가를 알린다 . 

⑤ QSqfformxreadFieldsO 함수를 호출하여 현재 레 코드로부터 편집 기창문부품들에 자료를 
옳긴다 . 

⑥ 대 화칸을 표시 한다 . 

⑦ QSqlForm :: writeFields() 함수를 호출하여 갱신된 값을 자료기지에 복사한다 . 

이것을 설명하기 위하여 CdForm 대화칸의 코드를 고찰한다 . 이 대화칸은 사용자가 CD 레 
코드를 창조하거나 편집하게 한다 . 사용자는 CD 의 제목，기사，제작년도와 매개 자리길의 제 


목과 연 주시 간을 지 정할수 있 다 . 




그림 12-4. CdForm 대 화칸 

클라스정의부터 고찰하자 . 

:lass CdForm : public QDialog 

{ 

Q_OBJECT 

public: 

CdForm(QWidget *parent = 0， const char *name = 0: 
CdForm(int id, QWidget ^parent = 0， const char *nan 
〜 CdForm(); 
protected slots: 
void accept(); 
void reject(); 
private slots: 

void addNewArtist(); 

void moveTrackUp(); 

void moveTrackDown(); 

void beforeInsertTrack(QSqlRecord ^buffer); 

void beforeDeleteTrack(QSqlRecord *buffer); 








private: 

void init(); 

void createNewRecord(); 

void swapTracks(int trackA, int trackB); 

QLabel *titleLabel; 

QLabel *artistLabel; 

QDataTable *trackTable; 

QSqlForm *sqlForm; 

QSqlCursor *cdCursor; 

QSqlCursor *trackCursor; 
int cdld; 
bool newCd; 

}； 

2 개 의 구성 자를 선 언한다 . 즉 하나는 새 CD 를 자료기 지 에 삽입 하기 위한 구성 자이 고 다 
른하나는 현 존 CD 를 갱 신 하기 위 한 구성 자이 다 . acceptO 와 reject () 처 리 부들은 QDialog 로부터 재 
정의된다 . 

CdForm: : CdForm(QWidget ^parent, const char *name) : QDialog(parent, name) 

{ 

setCaption ( 仕 ("Add a CD")); 
cdId#*H;init(); 

} 

첫 구성자는 대화칸의 제목을 "Add a CD ” 로 설정하고 비공개 init () 함수를 호출하여 남은 
일을 수행한다 . 

CdForm: : CdForm(int id, QWidget *parent, const char *name) : QDialog(parent, name) 

{ 

setCaption(tr("Edit a CD")); 

cdld = id; 

init(); 

} 

둘째 구성 자는 제 목을 ’’Edit a CD ’’ 로 설 정 하고 역 시 init () 를 호출한다 . 
void CdForm::init() 

{ 

db = QSqlDatabase::database("CD"); 
db->transaction(); 
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if (cdld = -1) 

createNewRecord(); 

init() 에서 는 CD 자료기 지 련결을 리 용하여 일괄처 리 를 시 작한다 . CdForm 과 ArtistFomi 에서 는 
다른 련결들을 사용해야 한다 . 그것은 두개 폼을 동시에 열고 한 폼이 다른 폼에 의해 시작 
된 일괄처리를 되살리려고 하지 않기때문이다 . 

조작할 CD 가 없다면 비공개함수 createNewRecordO 를 호출하여 자료기지에 빈 CD 를 삽입 
한다 . 이것은 자리길들의 QDataTable 에서 CD ID 를 외부열쇠로 사용하게 한다 . 사용자들이 
Cancel 을 찰칵하면 일괄처리를 되돌리고 빈 레코드는 표시되지 않는다 . 

이 대화칸에서 는 ArtistForm 에서 와는 다른 자료기 지련결을 사용한다 . 그것은 련결당 오직 
하나의 능동일괄처리를 가질수 있으므로 두 일괄처리를 요구하는 상황에서，례를 들면 사용 
자가 AddNew 를 찰칵하여 ArtistForm 을 펼치는 경우에 완료할수 있기때문이다 . 
titleLabel = new QLabel(tr("&Title: M ), this); 
artistLabel = new QLabel(tr("&Artist:"), this); 
yearLabel = new QLabel(tr("&Year: n ), this); 
titleLineEdit = new QLineEdit(this); 
yearSpinBox = new QSpinBox(this); 
yearSpinBox->setRange(l900, 2100); 
yearSpinBox->setValue(QDate :: currentDate() .year()); 
artistComboBox = new ArtistComboBox(db, this); 
artistButton new QPushButton(tr("Add &New..."), this); 


cancelButton = new QPushButton(tr("Cancel"), this); 

사용자대면부를 형성하는 표식자들과 행편집칸，스핀칸 , 복합칸，단추들을 창조한다 . 복합 
칸은 후에 설명 하는 ArtistComboBox 형 이다 . 

trackCursor = new QSqlCursor("track", true, db); 
trackTable = new QDataTable(trackCursor, false, this); 
trackTable->setFilter("cdid = " + QString: :number(cdld)); 
trackTable->setSort(trackCursor->index( n number M )); 
trackTable->addColumn("title", tr( M Track M )); 
trackTable->addColumn( ,, duration", tr(’’Duration’’)); 
trackTable->refresh(); 

사용자가 현재 CD 의 자리길들을 열람 및 편집하게 하는 QDataTable 을 설정한다 . 이것은 
앞 절에서 ArtistForm 클라스에 대하여 수행한것과 아주 비슷하다 . 
cdCursor = new QSqlCursor("cd", true, db); 
cdCursor->select( M id = " + QString: : number(cdld)); 
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cdCursor->next(); 

QSqlFomi 과 련관된 QSqlCursor 를 설정하고 그것이 현재 ID 를 가지는 레코드를 지적 하게 
한다 . 

QSqlPropertyMap *propertyMap = new QSqlPropertyMap; 
propertyMap->insert("ArtistComboBox M , ’’artistld’’); 
sqlForm = new QSqlForm(this); 
sqlForm->installPropertyMap(propertyMap); 
sqlForm->setRecord(cdCursor->primeUpdate()); 
sqlForm->insert(titleLineEdit, ’’title’’); 
sqlForm->insert(artistComboBox, "artistid”); 
sqlForm->insert(yearSpinBox, "year”); 
sqlForm->readFields(); 

QSqlPropertyMap 를 창조한다 . QSqlPropertyMap 클라스는 QSqlFomi 에게 어느 Qt 속성이 어떤 
형의 편집기창문부품의 값을 보관하는가를 말해준다 . 기정으로 이미 QSqlForm 은 QLineEdit 가 
값을 text 속성에 보관하고 QSpinBox 는 값을 value 속성에 보관한다는것을 알고있다 . 그러나 
ArtistComboBox 와 같은 사용자정의창문부품들에 대해서는 전혀 모른다 . 속성매프에 쌍 
( ， ’ ArtistComboBox", ’’artistld，，) 을 삽입하고 QSqlFomi 에 대하여 installPropertyMap() 을 호출함으로 
써 QSqlFomi 에 ArtistComboBox 형의 창문부품들에서 artistld 속성을 사용한다는것을 알린다 . 

또한 QSqlForm 객체는 조작할 완충기를 요구하며 완충기는 QSqlCursor 에 대하여 
primeUpdateO 를 호출하여 얻어지며 어느 편집기창문부품이 어느 자료기지마당에 대응하는가 
를 알아야 한다 . 끝으로 readFieldsO 를 호출하여 자료기 지 로부터 편집 기창문부품들에 자료를 
읽어들인다 . 

connect(artistButton, SIGNAL(clicked()), this, SLOT(addNewArtist())); 
connect(moveUpButton, SIGNAL(clicked()), this, SLOT(moveTrackUp())); 
connect(moveDownButton, SIGNAL(clicked()), this, S LOT (mo veTrackDown())); 
connect(updateButton, SIGNAL(clicked()), this, SLOT(accept())); 
connect(cancelButton, SIGNAL(clicked()), this, SLOT(reject())); 
connect(trackTable, SIGNAL(beforeInsert(QSqlRecord *)), this, 
SLOT(beforeInsertTrack(QSqlRecord *))); 


단추들의 clickedQ 신호들과 QDataTable 의 beforelnsertO 신호를 다음에 서술하는 비공개처리 
부들에 련결한다 . 


void CdForm::accept() 





sqlForm->writeFields(); 
cdCursor->update(); 
db->commit(); 

QDialog::accept(); 

} 

사용자가 Update 를 찰칵하면 자료를 QSqlCursor 의 편집완충기에 써넣고 update() 를 호출하 
여 자료기지에 대하여 UPDATE 를 수행하고 commitO 를 호출하여 실제로 레코드를 자료기지에 
써넣 으며 기 초클라스의 accept 실현을 호출하여 폼을 닫는다. 
void CdForm::reject() 

{ 

db->rollback(); 

QDialog::reject(); 

} 

사용자가 Cancel 을 찰칵하면 되돌아와서 자료기지를 변경하지 않은대로 놔두고 폼을 닫는 
다. 

void CdForm: : addNewArtist() 

{ 

ArtistForm form(this); 
if (form.exec()) { 

artistComboBox->refresh(); 

updateButton->setEnabled(artistComboBox->count() > 0); 

} 

} 

사용자가 Add New 를 찰칵하면 이 행 금지 ArtistForm 대 화칸을 펼 친 다. 대 화칸은 사용자가 새 
기사들을 추가하게 하고 또한 현존기사들을 편집 및 삭제하게 한다. 사용자가 Update 를 찰칵 
하면 ArtistComboBox 기 refresh() 를 호출하여 그 기사목록이 갱신되도록 한다. 

새 CD 를 기사이름이 없이 창조하지 않게 하려고 하므로 기사가 있는가 없는가에 따라 
Update 단추를 허 용하거 나 금지 한다. 

void CdForm::beforeInsertTrack(QSqlRecord ^buffer) 

{ 

buffer->setValue( M id M , generateld("track", db)); 
buffer->setValue( n number", trackCursor->size() + 1); 
buffer->setValue( n cdid", cdld); 

} 

beforeInsertTrack() 처 리 부는 QDataTable 의 beforeInsert() 신 호에 련 결 된 다. 레 코드의 id, 번 호, 



그리고 cdid 마당들을 설정한다 . 

void CdForm::beforeDeleteTrack(QSqlRecord *buffer) 

{ 

QSqlQuery query(db); 

query.exec("UPDATE track SET number = number -1 WHERE track.number > ，’ 

+ buflfer->value( M number").toString()); 

} 

beforeDeleteTrack () 처 리 부는 QDataTable 의 beforeDelete () 신 호에 련 결 된 다 . 삭제 한 자리 길 보다 
큰 수를 가지는 모든 자리길들의 번호를 다시 지정하여 자리길번호들이 련결되도록 한다 . 례 
를 들면 CD 에 6 개의 자리길이 있고 사용자가 자리길 4 를 삭제하면 자리길 5 는 자리길 4 로 되고 
자리길 6 은 자리길 5 로 된다 . 

아직 설명하지 않은 4 개의 함수 moveTrackUp(), moveTrackDown(), swapTracks(), 
createNewRecord () 가 있다 . 이 함수들은 응용프로그람을 사용할수 있게 하는데 필요하지만 그 
실현은 어떤 새로운 기술도 보여주지 않으므로 여기서 고찰하지 않는다 . 

이제는 CD Collection 응용프로그람의 모든 코드를 고찰하였으므로 사용자정의 
ArtistComboBox 를 고찰할 준비가 되였다 . 보통처럼 클라스정의부터 고찰하자 . 
class ArtistComboBox : public QComboBox 
{ 

Q_OBJECT 

Q_PROPERTY(int artistld READ artistld WRITE setArtistld) 
public: 

ArtistComboBox(Q SqlDatabase * database, Q Widget ^parent = 0, const char *name = 0); 

void refresh(); 

int artistld() const; 

void setArtistId(int id); 
private: 

void populate(); 

QSqlDatabase *db; 

QMap<int, int> idFromlndex; 

QMap<int, int> indexFromld; 

}； 

ArtistComboBox 클라스는 QComboBox 를 계승하며 artistld 속성과 일부 함수들을 추가한다 . 
비공개절에서는 기사 ID 들을 복합칸첨수들과 련결하는 QMap<int, 노 1 >와 복합칸첨수들을 
기 사正)들과 련 결 하는 QMap<int, 此>를 선 언 한다 . 

ArtistComboBox: :ArtistComboBox(QSqlDatabase * database, QWidget *parent, const char *name) 




: QComboBox(parent, name) 


db = database; 
populate(); 

} 

구성자에서는 비공개함수 populate^ 를 호출하여 복합칸에 기사표의 이름과 ID 들을 채운 
다 . 

void ArtistComboBox: : refresh() 

{ 

int oldArtistld = artistld(); 
clear(); 

idFromIndex.clear(); 
indexFromId.clear(); 
populate(); 

setArtistld(oldArtistld); 

} 

refresh() 함수에서는 복합칸에 자료기지의 최근자료를 다시 채운다 . 또한 갱신전에 선택되 
였던 기사가 자료기지로부터 삭제되지 않았으면 후에도 계속 선택되여 있도록 하는데 주의해 
야 한다 . 

void ArtistComboBox: : populate() 

{ 

QSqlCursor cursor(’’artist", true, db); 
cursor.select(cursor.index("name")); 
int index = 0; 
while (cursor.next()) { 

int id = cursor.value( n id M ).toInt(); 
insertItem(cursor.value( M name").toString(), index); 
idFromIndex[index] = id; 
indexFromId[id] = index; 

++index; 

} 

} 

비공개함수 populated) 에서는 모든 기사들을 순환하면서 QComboBox::insertItemO 를 호출하 
여 기사들을 복합칸에 추가한다 . 또한 idFromlndex 와 indexFromld 매프들을 갱신 한다 . 
int ArtistComboBox: : artistld() const 
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return idFromIndex[currentItem()]; 


artistld () 함수는 현재 기사의 ID 를 돌려준다 . 
void ArtistComboBox: : setArtistId(int id) 

{ 

if (indexFromld.contains(id)) 

setCurrentItem(indexFromId[id]); 

} 

setArtistId () 함수는 기사正)에 기초하여 현재기사를 설정한다 . 

흔히 외부열쇠들을 표시 하는 복합칸을 요구하는 응용프로그람들에서는 구성자가 표이름 , 
현시할 마당， ID 들에 사용할 마당을 지적하게 하는 일반 DatabaseComboBox 클라스를 창조할 때 
의의가 있다 . 

createConnectionsO 와 main () 함수를 실현하는것으로 CD Collection 응용프로그람을 끝낸다 . 
inline bool createOneConnection(const Q String &name) 

{ 

QSqlDatabase *db; 
if (name.isEmptyO) 

db = QSqlDatabase::addDatabase("QSQLITEX M )； 

else 

db = QSqlDatabase::addDatabase("QSQLITEX", name); 
db->setDatabaseName( n cdcollection.dat"); 
if (!db- 〉 open()) { 

db->lastError().showMessage(); 
return false; 

} 

return true; 

} 

inline bool createConnectionsO 

{ 

return createOneConnection( ,M, ) && createOneComection("ARTIST") 

&& createOneConnection( n CD M )； 

} 

createConnectionsO 에서는 CD 자료기지에 대한 3 개의 등가한 련결을 창조한다 . 첫째 련결에 
는 이름을 주지 않고 기정으로 자료기지를 지정하지 않을 때 사용한다 . 다른 련결들은 




ARTIST 와 CD 라고 부르고 ArtistForm 와 CdForm 이 사용한다 . 


int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 
if (! createConnections()) 
return 1; 

MainForm mainForm; 
app.setMainWidget(&mainForm); 
mainForm.resize(480, 320); 
mainForm. show(); 
return app.exec(); 

} 

main() 함수는 다른 대부분의 Qt main() 함수들과 비숫한데 createConnections() 호출이 추가된 
다 . 

앞 절의 마감에 언급한것처럼 한가지 가능한 개선은 매개 자리길의 연주시간을 초가 아 
니 라 분과 초로 표시하는것 이 다 . 또한 QSqlCursor :: calculateFieldO 을 재정 의함으로써 
QSqlEditorFactory 의 파생 클라스를 만들어 사용자정 의 편집 기 (QTimeEdit 에 기 초할수 있다)를 제 
공하며 QSqlPropertyMap 를 리용하여 QDataTable 에게 편집기로부터 값을 어떻게 얻는가 하는것 
을 알려준다.(자세한 정보는 QDataTable 의 installEditorFactory() 와 installPropertyMap() 함수들의 
방조를 참고하시오 .) 

또 하나의 개선은 자료기지에서 매개 CD 의 표지화상을 보관하고 CdForm 에 그것을 표시 
하는것이다 . 이것을 실현하려면 자료기지에서 화상자료를 BLOB 로서 보관하며 그것을 
QByteArray 로서 얻어서 QByteArray 를 Qlmage 구성자에 넘긴다 . 




제 13 장. 망프로그람작성 

Qt 는 FTP 및 HTTP 와 작업 하기 위한 QFtp 와 QHttp 클라스를 제 공한다 . 이 통신규약들은 
파일들을 내 리 적재 및 올리적재하는데 사용하기 쉬 우며 HTTP 의 경 우에 웨브봉사기 들에 요구 
를 보내고 결과를 얻는데 사용하기 편리하다 . 

Qt 의 QFtp 와 QHttp 클라스들은 TCP 소케트를 제공하는 저수준 QSocket 클라스에 구축된다 . 
TCP 는 망마디들사이 에 전송되는 자료흐름에 의 하여 조작된다 . 또한 QSocket 는 가동환경 에 고 
유한 망 API 와 가까운 QSocketDevice 에 실현된다 . QSocketDevice 클라스는 TCP 와 UDP 를 둘다 
유지 한다 . 

이 장에서는 우에서 언급한 4 개의 클라스들과 QServerSocket, QSocketNotifier 와 같이 밀접 
히 련관된 다른 클라스들의 사용법을 학습한다 . 또한 파일들의 올리적재와 내리적재를 고찰 
하고 웨브폼을 프로그람적으로 사용하는 방법을 고찰한다 . 봉사기프로그람과 대응하는 의뢰 
기 프로그람에 서 TCP 를 사용한다 . 마찬가지 로 송신 프로그람과 대 응하는 수신 프로그람에 서 
UDP 를 사용한다 . QFtp 와 QHttp 의 적용범위는 누구나 호출할수 있어 야 하지만 QSocket 와 특히 
QSocketDevice 의 적 용범 위 는 망프로그람작성 실험 을 가정 한다 . 

제1절. QFtp 의 리용 

QFtp 클라스는 Qt 에서 FTP 통신규약의 의뢰기측을 실현한다 . 이 클라스는 get(), put(), 
remove(), mkdir() 를 비롯한 가장 일반적인 FTP 조작들을 수행하기 위 한 여러가지 함수들을 제 
공하며 임의의 FTP 지령들을 실행하는 수단을 제공한다 . 

QFtp 클라스는 비 동기적 으로 작업한다 . get() 나 put() 와 같은 함수를 호출할 때 곧 되 돌아오 
며 Qt 의 사건순환고리로 조종이 넘어올 때 자료전송이 발생한다 . 이것은 FTP 지령들을 실행하 
는동안 사용자대면부에 응답성 이 유지된다는것을 담보한다 . 

getO 에 의해 하나의 파일을 얻는 방법 을 보여주는 실례로 시 작한다 . 실례는 응용프로그람 
의 MainWindow 클라스가 FTP 싸이 트로부터 값목록을 엄 는데 필요하다고 가정 한다 . 
class MainWindow : public QMainWindow 
{ 

Q_OBJECT 

public: 

MainWindow(QWidget ^parent = 0, const char *name = 0); 
void getPriceList(); 

private slots: 

void ftpDone(bool error); 
private: 



QFtp ftp; 
QFile file; 


이 클라스는 값목록파일을 얻는 공개함수 getPriceListO 와 파일전송이 완료될 때 호출되는 
비 공개처 리 부 ftpDone(bool) 을 가진다 . 또한 이 클라스는 2 개의 비 공개 변수를 가진다 . ftp 변수는 
QFtp 형 으로서 FTP 봉사기 에로의 련결을 밀봉하고 file 변수는 내 리적재한 파일을 디 스크에 써 넣 
는데 쓰인다 . 

MainWindow: :MainWindow(QWidget ^parent, const char *name) : QMainWindow(parent, name) 

{ 


connect(&ftp, SIGNAL(done(bool)), this, SLOT(ftpDone(bool))); 

} 

구성자에서는 QFtp 객체의 done(bool) 신호를 ftpDone(bool) 비공개 처리 부에 련결 한다 . QFtp 는 
모든 요구에 대한 처리가 끝났을 때 done(bool) 신호를 발생한다 . bo 이파라메터는 오유가 있는가 
없는가를 가리킨다 . 

void MainWindow: : getPriceList() 

{ 

file.setName( M price-list.csv"); 
if (! file.open(IO WriteOnly)) { 

QMessageBox: : waming(this, tr("Sales Pro"), 

tr(’’Cannot write file %l\n%2. M ) .arg(file.name()) .arg(file.errorString())); 
return; 

} 

ftp.connectToHost( n ftp.trolltech.com"); 

ftp.login(); 

ftp.cd( M /topsecret/csv n ); 
ftp.get("price-list.csv M , &file); 
ftp.close(); 

} 

getPriceList() 함수는 ftp://ftp.trolltech.com/topsecre^^ 일을 내리 적재 하여 현재 

등록부의 price-list.csv 로서 보관한다 . 

우선 써넣으려는 QFile 을 연다 . 그다음 QFtp 객체를 리용하여 5 개의 FTP 지 령을 차례로 실 
행 한다 . get() 의 둘째 인수는 출력 장치 를 지 정한다 . 

FTP 지령들은 (가의 사건순환고리에서 대기하고있다가 실행된다 . 지령의 완료는 구성자에 
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서 ftpDone(bool) 에 련결된 QFtp 의 done(bool) 신호에 의하여 알려진다 . 
void MainWindow: : ftpDone(bool error) 

{ 

if (error) 

QMessageBox: : waming(this, tr("Sales Pro"), 

tr("Error while retrieving file with FTP: %1.") .arg(ftp.errorString())); 
file.close(); 

} 

일단 FTP 지령들이 실행되면 파일을 닫는다 . 오유가 발생하면 그것을 QMessageBox 에 현 
시 한다 . 

QFtp 는 다음의 조작 즉 connectToHost(), login(), close(), list(), cd(), get(), put(), remove(), mkdir(), 
rmdir(), 그리고 renameO 를 제공한다 . 이 함수들은 모두 FTP 지령을 발생하고 지령을 식별하는 
ID 번호를 돌려준다 . 임의의 FTP 지령들은 rawCommandO 에 의해 실행될수 있다 . 례를 들면 여 
기에 SITE CHMOD 지령을 실행하는 방법이 있다 . 

ftp.rawCommandC'SITE CHMOD 755 fortune ")； 

QFtp 는 지령 실행을 시 작할 때 commandStarted(int) 신 호를 발생 하고 지령이 끝날 때 
commandFinished(int, bool) 신호를 발생한다 . int 파라메터는 지 령을 식 별하는 ID 번호이다 . 개 별적 
인 지령들의 수명에 관심이 있으면 지령들을 실행할 때 正)번호들을 보관할수 있다 . 正)번호를 
리용하여 사용자에게 지령에 대한 세부적인 처리를 제공할수 있다 . 례를 들면 
void MainWindow: :getPriceList() 

{ 


connectld = ftp.connectToHost("ftp.trolltech.com"); 

loginld = ftp.login(); 

cdld = ftp.cd( M /topsecret/csv M ); 

getld = ftp.get("price-list.csv", &file); 

closeld = ftp.close(); 

} 

void MainWindow: : commandStarted(int id) 

{ 

if (id == connectld) { 

statusBar()->message(tr( n Connecting... 

} else if (id == loginld) { 

statusBar()->message(tr( n Logging in...")); 



} 

반결합을 제공하는 다른 하나의 수법은 QFtp 의 stateChangedO 신호에 련결하는것 이 다. 
대부분의 응용프로그람들에서는 오직 지령들의 전체 렬에 관심을 가전다. 그때 지령기다 
림렬이 빌 때마다 발생되는 done ( bool ) 신호를 단순히 련결할수 있다. 

오유가 발생하면 QFtp 는 자동적으로 지 령 기 다림렬을 지 운다. 이 것은 련결 이 나 로그인 이 
실폐하면 기다림렬의 뒤를 따르는 지령들은 절대로 실행되지 않는다는것을 의미한다. 그러나 
오유발생후에 갈은 QFtp 객체를 리용하여 새 지 령들을 실행한다면 이 지 령들은 아무것도 발생 
하지 않은것처럼 기다렸다가 실행된다. 

그러면 더 고급한 실례를 고찰하자. 
class Downloader : public QObject 
{ 

Q_OBJECT 

public: 

Downloader(const QUrl &url); 
signals: 

void finished(); 
private slots: 

void ftpDone(bool error); 
void listInfo(const QUrllnfo &urlInfo); 
private: 

QFtp ftp; 

std::vector<QFile *> openedFiles; 

}； 

Downloader 클라스는 FTP 등록부에 배치되는 모든 파일들을 내리적재한다. 등록부는 클라 
스의 구성자에 넘긴 QUrl 로서 지 정된다. QUrl 클라스는 파일이름，경로，통신규약 및 포구와 같 
은 URL 의 각 부분들을 꺼내기 위한 고급한 대면부를 제공하는 Qt 클라스이다. 

Downloader: : Downloader(const QUrl &url) 

{ 

if (url.protocol() != "ftp") { 

QMessageBox: : waming(0, tr(’’Downloader’’), tr("Protocol must be ’ftp’.")); 

emit finished(); 

return; 

} 

int port = 21; 
if (url.hasPort()) 
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port = url.port(); 

connect(&ftp, SIGNAL(done(bool)), this, SLOT(ftpDone(bool))); 

connect(&ftp, SIGNAL(listInfo(const QUrllnfo &)), this, SLOT(listInfo(const QUrllnfo &))); 

ftp.connectToHost(url.host(), port); 

ftp.login(url.user(), url.password()); 

ftp.cd(url.path()); 

ftp.list(); 

} 

구성자에서는 우선 URL 이 " ftp :” 로 시작하는가 검사한다. 그다음 포구번호를 꺼낸다. 포구 
가 지정되지 않으면 FTP 의 기정포구인 포구 21을 사용한다. 

다음으로 2개의 신호-처리부련결을 확립하고 4개의 FTP 지령들을 실행한다. 마지막 FTP 
지 령 list 。 는 등록부안의 매개 파일이름을 얻으며 얻어지는 매개 이 름에 대하여 listInfo(const 
QUrllnfo &) 신호를 발생한다. 이 신호는 주어진 URL 과 련관된 파일을 내리적재하는 listlnfo () 
라고 부르는 처리부에 련결된다. 

void Downloader: :listInfo(const QUrllnfo &urlInfo) 

{ 

if (urlInfo.isFile() && urlInfo.isReadable()) { 

QFile *file = new QFile(urlInfo.name()); 
if (! file->open(IO_WriteOnly)) { 

QMessageBox: : waming(0, tr("Downloader n ), tr("Error: Cannot open file %l:\n%2.") 

.arg(file->name()) .arg(file->errorString())); 
emit finished(); 
return; 

} 

ftp.get(urllnfo.name(), file);openedFiles.push_back(file); 

} 

} 

listInfo() 처리 부의 QUrllnfo 파라메터는 원격파일에 대한 자세한 정보를 제공한다. 파일이 
표준파일(등록부아님)이고 읽기가능하다면 get() 를 호출하여 그것을 내리적재한다. 내리적재에 
사용된 QFile 객체는 new 에 의 하여 할당되고 그 지 적자는 openedFiles 벡토르에 보관된다. 
void Downloader :: ftpDone(bool error) 

{ 

if (error) 

QMessageBox: : waming(0, 仕 ("Downloader"), 仕 ("Error: %1.") .arg(ftp.errorString())); 
for (int 0;i < (int)openedFiles.size();++i) 




delete openedFiles[i]; 
emit finished(); 

} 

ftpDoneO 처리부는 FTP 지령들이 모두 완료하였을 때 혹은 오유가 발생하면 호출된다 . 
QFile 객체들을 삭제하여 기억루실을 방지하고 또한 매개 파일을 닫는다 . (QFile 해체자는 파일 
이 열 려있으면 자동적 으로 닫는다 .) 

오유가 없으면 FTP 지령들과 신호들의 렬은 다음과 갈다 . 
connectToHost(Aast) 
login() 
cdipath) 
list() 
emit 

get(file_l) 
emit listlnfo 예 2) 


emit listInfo("/e 」 V) 
gQt{file_N) 
emit done() 

가령 12 개 파일중 5 번째 파일을 내리적재하는동안 망오유가 발생하면 남은 파일들은 내 
리적 재되 지 않는다 . 될수록 많은 파일들을 내 리 적재하려고 한다면 하나의 대 책은 한번 에 하 
나씩 GET 조작을 실 행 하고 새 로운 GET 조작을 실 행 하기전 에 done(bool ) 신 호를 기 다리 는것 이 다 . 
listlnfoO 에서는 get() 를 호출하는것이 아니라 단순히 파일이름을 QStringList 에 추가하고 
done(bool ) 에서 다음 파일에 대하여 get () 를 호출하여 QS 仕 ingList 에 내리적재한다 . 그때 실행순 
서는 다음과 갈다 . 

comectToHost(Aast) 

login() 

cdipath) 

list () 

emit listInfo(/?/e_7) 
emit listlnfo{file_2) 

emit listlnfo{file_N) 
emit done() 



emit done() 
gQt(file_2) 
emit done() 


gQt(file_N) 
emit done() 

다른 대책은 파일당 하나의 QFtp 객체를 사용하는것이다 . 이것은 개별적인 FTP 련결들을 
통하여 파일들을 병렬로 내리적재하게 한다 . 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

QUrl url("ftp://ftp.example.com/"); 

if (argc >= 2) 
url = argv[l]; 

Downloader downloader(url); 

QObject: : connect(&downloader, SIGNAL(finished()),&app, SLOT(quit())); 

return app.exec(); 

} 

main() 함수로 프로그람을 끝낸다 . 사용자가 지령행에서 URL 을 지정하면 그것을 사용하고 
그렇지 않으면 ftp://ftp.example.com/ 에로 간다 . 

두 실례에서 get() 로 엄은 자료는 QFile 에 써넣어진다 . 사실은 그렇지 않은 경우도 있다 . 
기억기안의 자료가 요구된다면 QByteArray 를 포함하는 QIODevice 의 파생클라스인 QBuffer 를 
사용할수 있다 . 례를 들면 

QBuffer *buffer = new QBuffer(byteArray); 
buffer->open(IO_WriteOnly); 
ftp.get(urlInfo.name(), buffer); 

또한 get() 에 대 한 입 출력인수를 생 략하거 나 null 지 적 자를 넘 길수도 있다 . 그때 QFtp 클라스 
는 새 자료를 얻을 때마다 readyReadO 신호를 발생하고 자료는 readBlockQ 나 readAUO 에 의하 
여 읽어 들일수 있다 . 

자료를 내리적재하는동안 사용자에게 반결합을 제공하려고 한다면 QFtp 의 

dataTransferProgress(int, int) 신호를 QProgressBar 혹은 QProgressDialog 의 setProgress(int, int) 처리 
부에 련결한다 . 또한 QProgressBar 나 QProgressDialog 의 canceled() 신호를 QFtp 의 abort() 처 리부에 
련결 한다 . 


제 2 절 . QHttp 의 리용 

QHttp 클라스는 Qt 에서 HTTP 통신규약의 의뢰기측을 실현한다 . 이 클라스는 get() 와 post() 
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를 비롯한 가장 일반적인 HTTP 조작들을 수행하는 각종 함수들을 제공하고 임의의 HTTP 요구 
를 보내는 수단을 제공한다 . 앞 절에서 QFtp 와 QHttp 사이에 류사성이 많다는것을 보았다 . 

QHttp 클라스는 비 동기적 으로 작업한다 . get() 나 p OS t() 와 갈은 함수를 호출할 때 함수는 곧 
되돌아오고 후에 조종이 (가의 사건순환고리에 돌아올 때 자료전송이 발생한다 . 이것은 HTTP 
요구를 처 리하는동안에 응용프로그람의 사용자대 면부가 응답성 을 유지 하도록 한다 . 

Qt 응용프로그람의 MainWindow 클라스에서 Trolltech 의 웨브싸이트로부터 HTML 파일을 내 
리적 재하는 방법 을 보여 주는 실례를 고찰한다 . 머 리 부파일은 앞 절 에서 사용한것과 거의 비 
숫하므로 생략하는데 하나의 비공개 처리 부 (httpDone(bool)) 와 비공개 변수들 (QHttp 형의 http 와 
QFile 형의 file) 이 있다 . 

MainWindow: :MainWindow(QWidget ^parent, const char *name) : QMainWindow(parent, name) 

{ 


connect(&http, SIGNAL(done(bool)), this, SLOT(httpDone(bool))); 

} 

구성자에서는 QHttp 객체의 done(bool) 신호를 MainWindow 의 httpDone(bool) 처리부에 련결한 
다 . 

void MainWindow: : getFile() 

{ 

file.setName(’’aboutqt.htmr); 
if (! file .open(IO_WriteOnly)) | 

QMessageBox: : waming(this, tr( M HTTP Get"), tr(’’Cannot write file %l\n%2. M ) 
.arg(file.name()) 

.arg(file.errorString())); 

return; 

} 

http.se 任 iost("doc. 仕 olltech.com"); 
http.get("/3.2/aboutqt.html", &file); 
http.closeConnection(); 

} 

getFile() 함수는 http://doc.frolltech.eom/3.2/aboutqt.html 파일을 내리적재하여 현재등록부에 

aboutqt.html 로서 보관한다 . 

QFile 을 써넣기용으로 열고 QHttp 객체를 리용하여 3 개의 HTTP 요구들의 렬을 실행한다 . 
getO 의 둘째 인 수는 출력 장치 를 지 정한다 . 

HTTP 요구들은 어의 사건순환고리에서 기다렸다가 실행된다 . 지령의 완료는 구성자에서 
httpDone(bool) 에 련결된 QHttp 의 done(bool) 신호에 의해 지적된다 . 



void MainWindow: : httpDone(bool error) 

{ 

if (error) 

QMessageBox: : waming(this, tr("HTTP Get"), 

仕 ("Error while fetching file with HTTP: %1.") .arg(http.errorString())); 
file.close(); 

} 

일단 HTTP 요구들이 완료되면 파일을 닫는다 . 오유가 발생하였다면 QMessageBox 에 오유 
통보문을 현 시한다 . 

QHttp 는 다음의 조작 즉 setHost(), get(), post(), head() 를 제 공한다 . 례 를 들면 여 기 에 post() 
를 리 용하여 = va/we" 쌍들의 목록을 CGI 스크립트에 보내는 방법 이 있다 . 

http.setHost("www.example.com"); 

http.post("/cgi/somescript.py", QCString("x=200&y=320"), &file); 

많은 조종들에서 임의의 HTTP 머리부와 자료를 받아들이는 request() 함수를 사용할수 있다 . 
례를 들면 

QHttpRequestHeader header("POST", "/search.html"); 
header.setValue("Host", "www.trolltech.com"); 
header.setContentType("application/x-www-form-urlencoded"); 
http.setHost("www.trolltech.com"); 

http.request(header, QCS 仕 ing("qt-interest=on&search=opengr’)); 

QHttp 는 요구의 실행을 시작할 때 requestStarted(int) 신호를 발생하고 요구가 완료되였을 
때 requestFinished(int, bool) 신호를 발생 한다 . int 파라메 터는 요구를 식별하는 ID 번호이다 . 개별적 
인 요구들의 수명에 관심이 있다면 요구들을 실행할 때 ID 번호들을 보관할수 있다 . ID 번호를 
리용하여 사용자에게 요구에 대한 세부적 인 조종을 제공할수 있다 . 

대 부분의 응용프로그람들에서 는 요구들의 전체렬 이 성 과적 으로 끝났는가 아닌가를 알려 
고만 한다 . 이것은 요구기다림렬 이 비게 될 때 발생되는 done(bool) 신호에 련결하여 간단히 달 
성 한다 . 

오유가 발생 하면 요구는 자동적 으로 지 워진 다 . 그러 나 오유발생 후에 같은 QHttp 객 체 를 리 
용하여 새로운 요구를 실행한다면 이 요구들은 보통과 같이 기다렸다가 전송된다 . 

QFtp 처럼 QHttp 는 입출력장치를 지정할 대신에 사용할수 있는 readBlock() 와 readAll() 함수 
들은 물론 readyRead() 신호를 제공한다 . 또한 QProgressBar 혹은 QProgressDialog 의 setProgress(i 
nt, int) 처 리부에 련결할수 있는 dataTransferProgress(int, int) 신호를 제공한다 . 

제3절. QSocket 를 리용한 TCP 망프로그람작성 

QSocket 클라스는 TCP 의뢰기 와 봉사기 들을 실현하는데 쓰일수 있다 . TCP 는 FTP 와 HTTP 
를 비롯한 수많은 응용층 Internet 통신규약들의 기초를 이루는 전송층통신규약으로서 전용통신 




규약들에도 사용할수 있다 . 

TCP 는 흐름지향통신규약이 다 . 응용프로그람들에서 자료는 크고 평 탄한 파일보다도 긴 흐 
틈으로 나타난다 . TCP 상에서 구축된 웃준위 통신규약들은 일반적으로 행지향 혹은 블로크지향 
이다 . 

• 행지향통신규약들은 자료를 행바꾸기로 구분한 본문행으로 전송한다 . 

• 블로크지 향통신 규약들은 자료를 2 진 자료블로트들로 전 송하다 . 매 개 블로크는 크기 마당 
과 그뒤의 자료의 크기 byte 로 구성된다 . 

QSocket 는 QIODevice 를 계승하므로 QDataStream 혹은 QTextS 仕 earn 을 리용하여 읽고쓸수 
있다 . 망으로부터 자료를 읽 어들일 때 파일로부터 읽 어 들일 때 와 다른 한가지 중요한 차이 는 
>>연산자를 사용하기전에 동료로부터 충분한 자료를 받았다는것을 확인해 야 하는것 이 다 . 여 
기서의 실폐는 정의되지 않은 동작을 발생시킬수 있다 . 

이 절에서는 전용블로크지향통신규약을 사용하는 의뢰기와 봉사기의 코드를 고찰한다 . 의 
퇴 기는 Trip Planner 라고 부르고 사용자들이 다음번 렬차려 행을 계획하게 한다 . 봉사기는 Trip 
Server 라고 부르며 의뢰기 에 려 행정보를 제공한다 . Trip Planner 응용프로그람을 쓰는것으로 시 작 
한다 . 



그림 13-1. Trip Planner 응용프로그람 


Trip Planner 는 From 마당， To 마당， Date 마당 ， Approximate Time 마당 각각 하나씩 과 근사시 간이 
출발시간인가 도착시간인가를 선택하는 2 개의 라지오단추들을 제공한다 . 사용자가 Search 를 
찰칵할 때 응용프로그람은 요구를 봉사기 에 보내 고 봉사기 는 사용자의 기 준에 맞는 렬 차려행 
들의 목록으로 응답한다 . 목록은 Trip Planner 창문의 QListView 에 표시된다 . 창문의 제일 아래 
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에는 마지막조작의 상태를 보여주는 QLabel 과 QProgressBar 이 있다 . 

Trip Planner 의 사용자대면부는 Qt Designer 로 창조한다 . 여기서는 대응하는 .ui.h 파일의 원 
천 코드에 초점 을 둔다 . 다음의 4 개 변 수를 Qt Designer 의 Members 타브에 서 선 언 한다 . 

QSocket socket; 

QTimer connectionTimer; 

QTimer progressBarTimer; 

Q_UINT16 blockSize; 

QSocket 형 의 socket 변수는 TCP 련결을 밀봉한다 . connectionTimer 변수는 오래 지 속되 는 련결 
시간을 요구하는데 쓰인다 . progressBarTimer 변수는 응용프로그람이 작업중에 있을 때 진척상 
황띠를 주기적으로 갱신하는데 쓰인다 . 끝으로 blockSize 변수는 봉사기로부터 받은 블로크들을 
해석할 때 사용된다 . 
void TripPlanner: : init() 

{ 

connect(&socket, SIGNAL(connected()), this, SLOT(sendRequest())); 
connect(&socket, SIGNAL(connectionClosed()), this, SLOT(connectionClosedByServer())); 
connect(&socket, SIGNAL(readyRead()), this, SLOT(updateListView())); 
connect(&socket, SIGNAL(error(int)), this, SLOT(error(int))); 
connect(&connectionTimer, SIGNAL(timeout()), this, SLOT(connectionTimeout())); 
connect(&progressBarTimer, SIGNAL(timeout()), this, SLOT(advanceProgressBar())); 
QDateTime dateTime = QDateTime: : currentDateTime(); 
dateEdit->setDate(dateTime.date()); 
timeEdit->setTime(QTime(dateTime .time() .hour(), 0)); 

} 

init () 에서는 QSocket 의 connected(), connectionClosed(), readyRead(), error(int ) 신호들과 두개 
시계들의 timeoutO 신호들을 자체의 처 리부들에 련결한다 . 또한 Date 와 Approximate Time 마당들 
에 현재 날자와 시 간에 기 초한 기 정 값들을 채워넣 는다 . 
void TripPlanner: : advanceProgressBar() 

{ 

progressBar->setProgress(progressBar->progress() + 2); 

} 

advanceProgressBar () 처리부는 progressBarTimer 의 timeout () 신호에 련결된다 . 

진척상황띠를 2 단위 전진시킨다 . Qt Designer 에서 진척상황띠의 totalSteps 속성을 띠가 작업 
중지 시 기 로서 동작해 야 한다는것 을 의 미 하는 특수값인 0 으로 설 정한다 . 


void TripPlanner: : connectToServer() 



listView->clear(); 

socket.connectToHost( ,, tripserver.zugbahn.de ,, ? 6178); 
searchButton->setEnabled(false); 
stopButton->setEnabled(true); 
statusLabel->setText(tr("Connecting to server...")); 
connectionTimer.start(30 * 1000, true); 
progressBarTimer.start(200, false); 
blockSize = 0; 

} 

connectToServerO 처리부는 사용자가 람색을 시작하기 위하여 Search 를 찰칵할 때 실행된다 . 
QSocket 객체에 대하여 connecObHostO 를 호출하여 봉사기에 련결한다 . 이때 가상주를퓨터 
tripserver.zugbahn.de 를 포구 6178 에서 호출할수 있다고 가정한다 . (자기의 콤퓨터 에서 실례를 실 
행하려고 한다면 주를퓨터 이름을 국부주콤퓨터로 고친다 .) connectToHostO 호출은 비동기적 이고 
곧 되돌아온다 . 일반적으로 련결은 후에 수립된다 . QSocket 객체는 련결이 이루어지고 실행될 
때 connected () 신 호를 발생 하고 련 결 이 실 폐 하면 error(int) (오유코드와 함께)를 발생 한다 . 

다음으로 사용자대 면 부를 갱 신 하고 2 개 의 시계를 기 동한다 . 첫 째 시 계 connectionTimer 는 
련결이 30s 동안 이루어지지 않았을 때 절환되는 단일발사시계이다 . 둘째 시계 
progressBarTimer 는 매번 200ms 간격으로 사건을 발생하여 응용프로그람의 진척상황띠를 갱신 
하며 응용프로그람이 작업하고있다는 시각적인 암시를 사용자에게 준다 . 

끝으로 blockSize 변수를 0 으로 설정한다 . blockSize 변수는 봉사기로부터 받은 블로크의 길 
이를 보관한다 . 다음에는 블로크크기를 아직 모른다는것을 의미하는 값 0 을 사용하기로 선택 
하였다 . 

void TripPlanner: : sendRequest() 

{ 

QByteArray block; 

QDataStream out(block, IO WriteOnly); 
out.setVersion(5); 

out « (Q_UINT16)0 « (Q_UINT8) ’S’ 

« fromComboBox->currentText() 

« toComboBox->currentText() « dateEdit->date() 

« timeEdit->time(); 
if (departureRadioButton->isOn()) 
out « (Q_UINT8) 'D'; 
else 


out « (Q_UINT8) 'A'; 




out.device()->at(0); 

out « (Q_UINT16) (block.size() -sizeof(Q 一 UINT16)); 
socket.writeBlock(block.data(), block.size()); 
statusLabel->setText(tr( n Sending request...")); 

} 

sendRequest () 처 리 부는 련결 이 확립 되 였 다는것 을 가리 키 는 connected () 신호를 QSocket 객 체 
가 발생할 때 실행된다 . 그 처리부의 과제는 사용자가 입력한 모든 정보를 가지는 요구를 봉 
사기에 생성하는것이다 . 

요구는 다음 형식의 2 진블로크이다 . 


Q_UINT16 

이 마당을 제외한 블로크크기， byte 수 

Q_UINT8 

요구형(늘 ’S’) 

QString 

출발도시 

QString 

도착도시 

QDate 

려 행 날자 

QTime 

근사려행시간 

Q_UINT8 

시간은 출발시간 (’D’) 혹은 도착시간 (’A’) 이다 . 


우선 날자를 블로크라고 부르는 QByteArmy 에 써넣는다 . 블로크안에 자료를 모두 넣은 다 
음에야 처 음에 전송해 야 할 블로크의 크기 를 알수 있으므로 QSocket 에 직 접 자료를 써 넣 을수 
있다 . 

초기에 블로크크기로서 0 을 써넣고 다음에 자료의 나머지가 뒤에 온다 . 그다음 입출력장 
치(배경에서 QDataStream 에 의해 창조된 QBuffer ) 에 대하여 at(0 ) 을 호출하여 byte 배렬의 선두 
로 이동하고 블로크자료의 크기와 함께 0 을 다시 써넣는다 . 크기는 블로크크기에 

sizeof(Q_UINT16) (즉 2 ) 를 덜어서 byte 량에서 크기마당을 제외한다 . 그후에 QSocket 에 대하여 
writeBlock () 를 호줄하여 봉사기에 블로크를 보낸다 . 
void TripPlanner: : updateListView() 

{ 

connectionTimer.start(3 0 * 1000, true); 

QDataStream in(&socket); 

in.setVersion(5); 

for (;;) { 

if (blockSize == 0) { 

if (socket.bytesAvailable() < sizeof(Q_UINT16)) 
break; 
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in » blockSize; 


if (blockSize == OxFFFF) { 
closeConnection(); 

statusLabel->setText(tr("Found %1 trip(s)") .arg(listView->childCount())); 
break; 

} 

if (socket.bytesAvailable() < blockSize) 
break; 

QDate date; 

QTime departureTime; 

QTime arrivalTime; 

Q_UINT16 duration; 

Q UINT8 changes; 

QString trainType; 

in » date » departureTime » duration » changes » trainType; 
arrivalTime = departureTime.addSecs(duration * 60); 
new QListViewItem(listView, date.toString(LocalDate), 

departureTime.toString(tr(’’hh:mm")) ， arrivalTime.toString(tr( M hh:mm n )), 
tr("%l hr %2 min") .arg(duration / 60) .arg(duration % 60), 

QString: : number(changes), trainType); 
blockSize = 0; 

} 

} 

updateListViewO 처리 부는 QSocket 가 봉사기로부터 새 자료를 수신 할 때마다 발생되는 
QSocket 의 readyRead () 신호와 련결된다 . 처음으로 할 일은 단일발사련결시계를 재기동하는것이 
다 . 봉사기로부터 자료를 수신할 때마다 련결이 살아있다는것을 알고있으므로 시계가 30s 동안 
실행되도록 설정한다 . 

봉사기 는 사용자의 기 준에 맞는 가능한 렬차려행목록을 송신한다 . 그 매개 려행은 단일블 
로크로서 전송되고 매개 블로크는 크기로 시작된다 . for 순환의 코드가 복잡한것은 봉사기로부 
터 한번에 1 개 자료블로크를 꼭 얻지 못하는데 있다 . 블로크전체 혹은 블로크의 일부 혹은 
1.5 개블로크 , 지어는 모든 블로크들을 한번에 수신할수 있다 . 

.51 bytes , , 48 bytes , _ 53 bytes ^ 


| 5l|| data \ 

| 48|| data | 


| 53|| data | 

| OxFFFF | 


그림 13-2. Trip Server 의 블로크들 
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그러 면 for 순환이 어떻 게 작업 하는가 ? blockSize 변수가 0 이 면 이 것은 다음 블로크의 크기 를 
읽지 못했다는것을 의미하므로 그것을 읽으러고 한다 . (읽을수 있는것이 적어도 2byte 있다고 
가정한다 .) 봉사기 는 값 Ox 抑 FF 를 사용하여 받을 자료가 더 는 없다는것 을 지 정 하므로 이 값 
을 읽어들이면 끝에 이르렀다는것을 알게 된다 . 

블로크크기가 OxFFFF 아니면 다음 블로크를 읽으러고 시도한다 . 우선 읽을수 있는 블로크 
크기 byte 가 있는가 알아보려 고 한다 . 없으면 거 기서 중지한다 . 유효자료가 있으면 readyRead() 
신호가 다시 발생되고 그다음 다시 시도한다 . 

블로크전체가 도착했다는것 이 확실하면 QSocket 에 설정한 QDataStream 에 대하여 »연산 
자를 리용하여 려행과 관련한 정보를 안전하게 꺼 내고 그 정보를 리용하여 QListViewItem 을 
창조한다 . 봉사기로부터 수신한 블로크는 다음의 형식을 가전다 . 


Q_UINT16 

이 마당을 제외한 블로크크기， byte 수 

QDate 

출발날자 

QTime 

출발시간 

Q_UINT16 

운행시 분 

Q—UINT8 

변경회수 

QString 

렬차형 


끝으로 blockSize 변수를 0 으로 재설정하여 다음 블로크의 크기가 알려지지 않았고 읽어들 
여 야 한다는것을 가리킨다 . 

void TripPlanner: :closeConnection() 

{ 

socket.close(); 

searchButton->setEnabled(true); 
stopButton->setEnabled(false); 
connectionTimer.stop(); 
progressBarTimer. stop(); 
progressBar->setProgress(0); 

} 

closeConnection() 비공개함수는 TCP 봉사기에로의 련결을 닫고 사용자대면부를 갱신하고 시 
계들을 정지시킨다 . 이 함수는 OxFFFF 를 읽어들일 때 updateListViewO 로부터 호출되며 우리가 
간단히 설명하는 다른 처리부들로부터도 호출된다 . 


void TripPlanner: : stopSearchQ 





statusLabel->setText(tr("Search stopped")); 
closeConnection(); 

} 

stopSearch() 처리부는 Stop 단추의 clicked() 신호에 련결된다 . 본질상 이것은 closeConnection() 
를 호출한다 . 

void TripPlanner: : connectionTimeout() 

{ 

statusLabel->setText(tr( n Error: Connection timed out’’)); 
closeConnection(); 

} 

connectionTimeout() 처 리 부는 connectionTimer 의 timeout() 신 호에 련 결 된 다 . 
void TripPlanner: : connectionClosedByServer() 

{ 

if (blockSize != OxFFFF) 

statusLabel->setText(tr( M Error: Connection closed by server")); 
closeConnection(); 

} 

connectionClosedByServer() 처 리 부는 소케 트의 coimectionClosed() 신 호에 련 결 된 다 . 

봉사기가 련결을 닫고 아직 흐름끝표식기호인 OxFFFF 를 수신하지 못했으면 사용자에게 
오유가 발생하였다고 알린다 . 보통처럼 closeConnectionO 를 호출하여 사용자대면부를 갱신하고 
시계들을 정지시킨다 . 

void TripPlanner :: error(int code) 

{ 

QString message; 
switch (code) { 

case QSocket::ErrConnectionRefused: 

message = tr( M Error: Connection refused"); 
break; 

case QSocket::ErrHostNotFound: 

message = tr("Error: Server not found’’); 
break; 

case QSocket::ErrSocketRead: 
default: 

message = tr( n Error: Data transfer failed"); 

} 
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statusLabel->setText(message); 

closeConnection(); 

} 

error(int ) 처리 부는 소케트의 error(int ) 신호에 련결되고 오유코드에 기초한 오유통보문를 생 
성 한다 . 

Trip Planner 응용프로그람의 mainO 함수는 우리 가 기 대 한것 과 같다 . 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

TripPlanner tripPlanner;app.setMainWidget(&tripPlanner); 
tripPlanner. show(); 
return app.exec(); 

} 

그러면 봉사기를 실현하자 . 봉사기는 2 개의 클라스 즉 TripServer 와 ClientSocket 로 이루어 
진다 . TripServer 클라스는 들어오는 TCP 련결을 받아들이는 클라스 QServerSocket 를 계승한다 . 
ClientSocket 는 QSocket 를 재정의하며 단일련결을 처 리 한다 . 임의의 시간에 기 억 기 에는 봉사받 
고있는 의뢰기로서 많은 ClientSocket 객체가 있을수 있다 . 
class TripServer : public QServerSocket 
{ 

public: 

TripServer(QObject ^parent = 0， const char *name = 0); 
void newConnection(int socket); 

}； 

TripServer 클라스는 QServerSocket 로부터 newConnection () 함수를 재정의한다 . 이 함수는 봉 
사기가 요구를 받으러는 포구에 의뢰기가 련결하려고 시도할 때마다 호출된다 . 

TripServer::TripServer(QObject *parent, const char *name) 

: QServerSocket(6178, 1, parent, name) {} 

TripServer 구성자에서는 포구번호 (6178 ) 를 기초클라스구성자에 넘긴다 . 둘째 인수 1 은 허용 
련결수이다 . 

void TripServer: : newConnection(int socketld) 

{ 

ClientSocket * socket = new ClientSocket(this); 
socket->setSocket(socketId); 

} 

newConnection () 에서는 ClientSocket 객체를 TripServer 객체의 자식으로 창조하고 그 소케트 




ID 를 주어진 수로 설정한다 . 


class ClientSocket : public QSocket 

{ 

Q_OBJECT 

public: 

ClientSocket(QObject ^parent = 0， const char *name = 0); 
private slots: 

void readClient(); 
private: 

void generateRandomTrip(const QString &from, const QString &to, const QDate &date, 
const QTime &time); 

Q_UINT16 blockSize; 

}； 

ClientSocket 클라스는 QSocket 를 계승하며 단일의뢰기의 상태를 밀봉한다 . 
ClientSocket::ClientSocket(QObject *parent, const char *name) : QSocket(parent, name) 

{ 

connect(this, SIGNAL(readyRead()), this, SLOT(readClient())); 
connect(this, SIGNAL(connectionClosed()), this, SLOT(deleteLater())); 
connect(this, SIGNAL(delayedCloseFinished()), this, SLOT(deleteLater())); 
blockSize = 0; 

} 

구성자에서는 필요한 신호-처리부련결을 확립하고 blockSize 변수를 0 으로 설정하여 의뢰 
기로부터 보내온 블로크크기를 아직 모른다는것을 가리킨다 . 

connectionClosed () 와 delayedCloseFinished () 신호는 (가의 사건순환고리에로 조종이 돌아올 
때 객체를 삭제하는 QObject 계승함수 deleteLaterO 에 련결된다 . 이것은 동료에 의해 련결이 닫 
길 때 혹은 지연된 닫기를 완료할 때 ClientSocket 객체가 삭제된다는것을 담보한다 . 
void ClientSocket: : readClient() 

{ 

QDataStream in(this); 
in.setVersion(5); 
if (blockSize = 0) { 

if (bytesAvailable() < sizeof(Q_UINT16)) 
return; 

in » blockSize; 

} 
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if (bytesAvailable() < blockSize) 
return; 

Q—UINT8 requestType; 

QString from; 

QString to; 

QDate date; 

QTime time; 

0—UINT8 flag; 

in » requestType; 

if (requestType == ， S，) { 

in » from » to » date » time » flag; 
srand(time.hour() * 60 + time.minute()); 
int numTrips = rand() % 8; 
for (int i = 0;i < numTrips;++i) 

generateRandomTrip(from, to, date, time); 

QDataStream out(this); 
out « (Q_UINT16)0xFFFF; 

} 

close(); 

if (state() == Idle) 
deleteLater(); 

} 

readClient() 처리부는 QSocket 의 readyRead() 신호에 련결된다 . blockSize 가 0 이면 blockSize 를 
읽는것으로 시작하고 그렇지 않으면 그것을 이미 읽었으므로 그대신에 전체 블로크가 도달했 
는가 검사한다 . 전체 블로크를 읽 을 준비 가 되 였으면 읽어 들인다 . QSocket(tW S 객체;)에 대하여 
직 접 QDataStream 을 사용하며 »연산자에 의 하여 마당을 읽어 들인다 . 

의뢰기의 요구를 읽었으면 응답을 생성할 준비가 된다 . 이것이 실제현장에서 가동하는 응 
용프로그람이면 렬차시 간표자료기 지 에서 정 보를 검 색하여 일치 하는 렬차려행을 찾으러 고 시 
도한다 . 그러 나 여 기서는 우연적 인 려행을 생성 하는 generateRandomTripO 라는 함수로 충족시 
킨다 . 이 함수를 우연회수 호출하고 OxFFFF 를 보내여 자료의 끝을 지정한다 . 

끝으로 련결을 닫는다 . 소케트의 출력완충기가 비였으면 련결은 곧 끝나고 조종이 Qt 의 
사건순환고리로 돌아올 때 deleteLater() 를 호출하여 이 객체를 삭제한다 . (이것은 delete this 보다 
더 안전하다 .) 그렇지 않으면 QSocket 는 모든 자료전송을 끝내고 련결을 닫으며 
delayedCloseFinished() 신 호를 발생 한다 . 

void ClientSocket::generateRandomTrip(const QString &， const QString &, const QDate &date, 






const QTime &time) 

{ 

QByteArray block; 

QDataStream out(block, IO WriteOnly); 
out. setVersion(5); 

Q—UINT16 duration = rand() % 200; 
out « (Q_UINT16)0 « date « time « duration 
« (Q_UINT8) 1 « QString( M InterCity n )； 
out.device()->at(0); 

out « (Q_UINT16) (block.size() -sizeof(Q_UINT16)); 
writeBlock(block.data(), block.size()); 

} 

generateRandomTripO 함수는 TCP 련결에서 자료블로크를 송신하는 방법을 보여준다 . 이것은 
의뢰기의 sendRequestO 함수에서 수행한것과 거의 비숫하다 . 다시 한번 블로크를 QByteArray 에 
써넣고 writeBlockQ 에 의해 송신하기전에 크기를 결정할수 있다 . 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

TripServer server; 
if (!server.ok()) { 

qWamingC'Failed to bind to port"); 



} 

QPushButton quitButton(QObject: : tr( n &Quit"), 0); 
quitButton.setCaption(QObject: : tr("Trip Server")); 
app. setMainWidget(&quitButton); 

QObj ect: :connect(&quitButton, SIGNAL(clicked()), &app, SLOT(quit())); 
quitButton. show(); 
return app.exec(); 

} 

main() 에서는 TripServer 객체와 사용자가 봉사기를 정지시킬수 있는 QPushButton 을 창조한 
다 . 

이로서 의뢰기-봉사기실례를 끝낸다 . 이 경우에 읽고쓰기에 QDataStream 을 사용하는 블로 
크지향통신규약을 사용하였다 . 행지향통신규약을 사용하려고 하는 경우에 가장 간단한 수법 
은 readyRead() 신호에 련결된 처리부에서 QSocket 의 canReadLineQ 과 readLine() 함수를 사용하는 
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것이다 . 

QStringList lines; 

while (socket.canReadLine()) 

lines.append(socket.readLine()); 

그다음 읽어 들인 매 행을 처 리한다 . 자료전송에서와 같이 이 것은 QSocket 에서 
QTextStream 을 사용하여 수행한다 . 

우리가 사용한 봉사기실현은 련결이 많을 때에는 잘 동작하지 않는다 . 문제는 요구를 처 
리하는동안 다른 련결을 처리하지 못하는데 있다 . 더 합리적인 수법은 매개 련결에 대하여 
새 스레드를 시작하는것이다 . 그러나 QSocket 는 오직 사건순환고리를 포함하는 스레드 
(QApplication :: exec() 호출)에서 사용할수 있다 . 그 리 유는 17 장 ( 다중스레드프로그람작성)에서 설 
명한다 . 해결책 은 사건순환고리 에 의 존하지 않는 저 수준의 QSocketDevice 클라스를 직 접 사용 
하는것 이 다 . 


제 4 절 . QSocketDevice 를 리용한 UDP 망프로그람작성 

QSocketDevice 클라스는 TCP 와 UDP 에서 사용할수 있는 저수준대면부를 제공한다 . 대부분 
의 TCP 응용프로그람들에 서는 고수준 QSocket 클라스를 요구하지만 UDP 를 사용하려면 직접 
QSocketDevice 를 사용해 야 한다 . 

UDP 는 믿음성없는 데 이 터그램지향통신규약이다 . 일부 응용층통신규약들은 TCP 보다 더 
가벼운 UDP 를 사용한다 . UDP 에서 자료는 한 주콤퓨터로부터 다른 주콤퓨터 에로 파케트(데 이 
터그램들)로서 송신된다 . 거기에는 련결이란 개념이 없고 UDP 파케트가 성공적으로 송달되지 
않아도 체계에는 오유가 통보되지 않는다 . 



Dale: 

|Mon Oct 202003| 

Time: 

118:56:42 

Temperature: 

1-18.9367 *C 

Humidity: 

120.7557*4 

Altitude: 

17000.89 m 


그림 13-3. Weather Station 응용프로그람 

Weather Balloon 과 Weather Station 실례를 통하여 Qt 응용프로그람으로부터 UDP 의 사용법을 
알게 된다 .WeatherBalloon 응용프로그람은 5s 간격으로 현재 대기조건을 포함하는 UDP 데이터그 
램 을 보내 는 비 GUI 응용프로그람이 다 . Weather Station 응용프로그람은 이 데 이 터 그램 들을 수신하 
여 화면 에 현 시 한다 . Weather Balloon 의 코드를 고찰하는것 부터 시 작한다 . 
class WeatherBalloon : public QPushButton 
{ 
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Q_OBJECT 

public: 

WeatherBalloon(QWidget *parent = 0, const char *name = 0); 
double temperature() const; 
double humidity() const; 
double altitude() const; 
protected: 

void timerEvent(QTimerEvent *event); 
private: 

QSocketDevice socketDevice ;int myTimerld; 

}； 

WeatherBalloon 클라스는 QPushButton 을 계승한다 . 이것은 Weather Station 과 교제하는데 그 
QSocketDevice 비 공개 변 수를 사용한다 . 

WeatherBalloon: :WeatherBalloon(QWidget ^parent, const char *name) 

: QPushButton(tr("Quit"), parent, name), socketDevice(QSocketDevice::Datagram) 

{ 

socketDevice.setBlocking(false); 
myTimerld = startTimer(5 * 1000); 

} 

구성 자의 초기 화목록에 서 는 QSocketDevice: :Datagram 을 QSocketDevice 구성 자에 넘기여 
UDP 소케트장치를 창조한다 . 구성자본체에서는 setBlocking(false) 를 호출하여 QSocketDevice 를 
비 동기 로 만든다 . (기 정 으로 QSocketDevice 는 동기 적 이 다 .：) 
startTimerQ 를 호출하여 5s 간격 으로 시 계사건을 생 성한다 . 
void WeatherBalloon::timerEvent(QTimerEvent *event) 

{ 

if (event->timerld() == myTimerld) { 

QByteArray datagram; 

QDataStream out (datagram, IO WriteOnly); 
out.setVersion(5); 

out « QDateTime :: currentDateTime() « temperature() « humidity() « altitude(); 
socketDevice.writeBlock(datagram, datagram.size(), 0x7F000001, 5824); 

} else { 

QPushButton: : timerEvent(event); 

} 


} 
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시계사건처리함수에서는 현재 날자 , 시간 , 온도 , 습도 , 표고를 포함하는 데이터그램을 생 
성 한다 . 


QDateTime 

측정날자와 시간 

double 

온도 (°c) 

double 

습도 (%) 

double 

표고 (m) 


데이터그램은 writeBlock() 에 의해 송신된다 . writeBlock() 의 셋째와 넷째 인수는 IP 주소와 
동료 (Weather Station) 의 포구번호이다 . 이 실례에서는 Weather Balloon 과 같은 콤퓨터에서 
father Station 를 실행하고있다고 가정하므로 국부주콤퓨터를 지정하는 특수 IP 주소인 127.0.0.1 
(0x7F000001) 을 사용한다 . QSocket 와 달리 QSocketDevice 는 주콤퓨터이 름을 받아들이 지 않고 
주콤퓨터번호만 받아들인다 . 여 기서 주콤퓨터이 름을 IP 주소로 해 결하려 고 한다면 QDns 클라스 
를 사용해야 한다 . 

보통과 같이 main() 함수가 필요하다 . 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

WeatherBalloon balloon; 

balloon.setCaption(QObject: :tr("Weather Balloon’’)); 

app.setMainWidget(&balloon); 

QObject::connect(&balloon, SIGNAL(clicked()), &app, SLOT(quit())); 

balloon.show(); 

return app.exec(); 

} 

mainO 함수는 단순히 WeatherBalloon 객체를 창조하고 이 객체는 UDP 동료로서 그리고 화면 
우의 QPushButton 으로서 모두 작업한다 . QPushButton 을 찰칵하여 사용자는 응용프로그람을 중 
지할수 있 다 . 

이제는 Weather Station 의 원천코드를 고찰하자 . 
class Weatherstation : public QDialog 
{ 

Q_OBJECT 

public: 

WeatherStation(QWidget ^parent = 0, const char *name = 0); 
private slots: 

void dataReceivedQ; 






private: 

QSocketDevice socketDevice; 
QSocketNotifier *socketNotifier; 
QLabel *dateLabel; 

QLabel *timeLabel; 


QLineEdit *altitudeLineEdit; 

}； 

Weatherstation 클라스는 QDialog 를 계승한다 . 이 클라스는 일정한 UDP 포구를 청 취 하여 
Weather Balloon 으로부터 들어오는 데이터그램들을 해석하고 5 개의 읽기전용 QLineE 出 t 들에 그 
내 용을 현 시한다 . 

클라스에는 2 개의 비공개변수 socketDevice 와 socketNotifier 가 있다 . socketDevice 변수는 
QSocke 江 Device 형으로서 데이터그램들을 읽 어들이는데 쓰인다 . socketNotifier 변수는 

QSocketNotifier 형이고 응용프로그람이 들어오는 데이터그램들을 인식하게 만든다 . 
Weatherstation: :WeatherStation(QWidget ^parent, const char *name) 

: QDialog(parent, name), socketDevice (QSocketDevice :: Datagram) 

{ 

socketDevice.setBlocking(false); 
socketDevice.bind(QHostAddress(), 5824); 

socketNotifier = new QSocketNotifier(socketDevice.socket(), QSocketNotifier: : Read, this); 
connect(socketNotifier, SIGNAL(activated(int)), this, SLOT(dataReceived())); 


} 

구성자의 초기화목록에서 는 QSocketDevice ::Datagram 을 QSocketDevice 구성자에 넘기여 
UDP 소케트장치를 창조한다 . 구성자본체에서는 setBlocking(false) 를 호출하여 소케트를 비동기 
로 만들고 bind() 를 호출하여 포구번호를 소케트에 할당한다 . 첫째 인수는 Weather Station 의 IP 
주소이다 . QHostAddress() 를 넘김으로써 Weather Station 가 실행 중에 있는 콤퓨터 에 속하는 IP 주 
소에 데이터그램들을 받아들인다는것을 지적 한다 . 둘째 인수는 포구번호이 다 . 

그다음 소케트를 감시하는 QSocketNotifier 객체를 창조한다 . 소케트가 데이터그램을 수신 
할 때마다 QSocketNotifier 는 activated(int) 신호를 발생 한다 . 그 신호를 dataReceived() 처리 부에 
련결 한다 . 

void Weatherstation :: dataReceived() 

{ 

QDateTime dateTime; 
double temperature; 
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double humidity; 
double altitude; 

QByteArray datagram(socketDevice.bytesAvailable()); 
socketDevice.readBlock(datagram.data(), datagram.size()); 

QDataStream in(datagram, IO ReadOnly); 
in.setVersion(5); 

in » dateTime » temperature » humidity » altitude; 
dateLineEdit->setText(dateTime.date().toString()); 
timeLineEdit->setText(dateTime.time().toString()); 
temperatureLineEdit->setText(tr( M % 1 °C M ).arg(temperature)); 
humidityLineEdit->setText(tr( M % 1 % ,, ).arg(humidity)); 
altitudeLineEdit->setText(tr( M % 1 m M ).arg(altitude)); 

} 

dataReceived() 에서는 QSocketDevice 에 대하여 readBlock() 를 호출하여 데 이터그램을 읽어들 
인다 . QByteArray::data() 는 readBlock() 가 채워넣는 QByteArray 자료의 지 적 자를 돌려 준다 . 그다 
음 QDataStream 를 리 용하여 각이한 마당들을 엄 고 사용자대 면부를 갱 신하여 수신 한 정 보를 
표시한다 . 응용프로그람의 견지 에서 데 이 터그램들은 늘 자료의 한단위 로 송수신된다 . 이 것은 
임의의 바이트들이 유효하다면 꼭 하나의 데이터그램이 도착하였고 읽어들일수 있다는것을 
의 미 한다 . 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

Weatherstation station; 
app.setMainWidget(&station); 
station.show(); 
return app.exec(); 

} 

끝으로 mainO 에서는 Weatherstation 을 창조하고 그것을 응용프로그람의 기본창문부품으로 
만든다 . 

이로서 UDP 송신기와 수신기를 끝낸다 . 응용프로그람들은 아주 간단하며 데이터그램들을 
보내는 Weather Balloon 과 그것들을 받아들이는 Weather Station 이다 . 현실세계의 대다수 응용프 
로그람들은 두 응용프로그람이 자기 소케트에 대한 읽기와 쓰기를 모두 요구한다 . 
QSocketDevice 클라스는 봉사기에서 어느 주소와 포구에 응답하는가를 결정하는데 사용하는 
peerAddress() 와 peerPort() 함수를 가지고있다 . 
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제 14 장. XML 


XML(Extensible Markup Language) 은 자료교환과 자료보관에서 큰 인기를 끌고있는 본문파 
일형식이다 . 

Qt 는 XML 문서 를 처 리 하기 위한 2 가지 다른 API 를 제 공한다 . 

• SAX(Simple API for XML) 는 가상함수들을 통하여 응용프로그람에 직 접 사건해 석 을 통보 
한다 . 

- DOM(Document Object Model) 은 XML 문서를 응용프로그람이 항행 할수 있는 나무구조로 
변환한다 . 

특정 한 응용프로그람에서 DOM 과 SAX 중 하나를 선택 할 때 고려해 야 할 인자들이 많다 . 
SAX 는 준위가 낮고 보통 빠르다 . 이것은 단순한 과제들 (XML 문서에서 주어진 꼬리표의 출현 
을 모두 찾는것 등)과 기 억기를 많이 소비하는 대규모파일들을 읽어들이는데 특히 적 합하다 . 
그러나 대부분의 응용프로그람들에서 DOM 이 제공하는 편리성은 SAX 의 잠재적인 속도와 기 
억기리득보다 더 크다 . 

이 장에서는 두 API 를 리용하여 XML 파일들을 읽는 방법과 XML 파일들을 작성하는 방법 
을 설 명한다 . 이 장은 XML 의 기 초지 식 을 전제 로 하고있다 . 

제1절. SAX 에 의한 XML 읽기 

SAX 는 사실상 XML 문서 들을 읽 어 들이 기 위 한 공개 적 인 표준 Java API 이 다 . 어의 SAX 클라 
스들은 SAX2Java 실현후에 모형화되고 Qt 관례에 일치지켰으므로 좀 차이가 있다 . 

Qt 는 QXmlSimpleReader 라고 부르는 SAX 에 기초하는 비합법적인 XML 문장해석기를 제공 
한다 . 이 문장해석 기 는 잘 형식 화된 XML 을 인식 하고 XML 이 름공간들을 유지한다 . 문장해석 
기가 문서를 읽어들일 때 등록된 처리함수클라스들의 가상함수들을 호출하여 문장해석사건들 
을 가리킨다 . (이 《문장해석사건》들은 건과 마우스사건들과 갈은 Qt 사건들에 관련되지 않는 
다 .:) 례를 들면 문장해석기가 다음의 XML 문서를 해석하고있다고 가정한다 . 

<doc> 


<quote>Errare humanum est</quote> 

</doc> 

문장해석기는 다음과 같은 문장해석사건처 리함수들을 호출한다 . 
startDocument() 
startElement(’’doc") 
startElement("quote M ) 
characters("Errare humanum est”) 
endElement( M quote M ) 
endElement( "doc") 
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endDocument() 

우의 함수들은 모두 QXmlContentHandler 에서 선언된다 . 단순성을 위하여 startElementO 와 
endElementO 의 일부 인수들을 생략하였다 . 

QXmlContentHandler 는 QXmlSimpleReader 와 결합하여 사용할수 있는 수많은 처리함수클라 
스들중 하나이다 . 그밖에 QXmlEntityResolver, QXmlDTDHandler, QXmlErrorHandler, 
QXmlDeclHandler ， QXmlLexicalHandler 가 있다 . 이러한 클라스들은 오직 순수가상함수들만 선언 
하며 각종 문장해석사건들에 대한 정보를 준다 . 대부분의 응용프로그람들에서는 오직 
QXmlContentHandler 와 QXmlErrorHandler 두개만 요구한다 . 

또한 편리상 Qt 는 다중계승을 통하여 모든 처리함수클라스들을 계승하며 모든 함수들의 
일반적실현을 주는 QXmmefaultHandler 클라스를 제공한다 . 이 설계는 많은 추상처리함수클라 
스들과 하나의 일반파생클라스를 가지는데 이것은 일반적으로 Qt 가 아니라 Java 실현모형에 
기초하고있 다 . 

이제는 QXmlSimpleReader 와 QXmlDefaultHandler 를 사용하여 특별한 XML 파일형식을 해석 
하고 그 리용을 QListView 에 표시하는 방법을 보여주는 실례를 고찰한다 . QXmlDefaultHandler 
파생클라스를 SaxHandler 라고 하고 그 처리형식은 색인항목과 보조항목들을 가지는 도서색인 
이다 . 

QXmlContentHandler QXmlDTDHarxJler QXmlLexicalHan<jler 

I QXmlErrorHandler I QXm I Entity Resolver I QXmlOecIHandler 

__ ( 

QXmlDefaultHandler 

I 

SaxHandler 

그림 14-1. SaxHandler 의 계 승나무 

여기에 그림 14-2 의 QListView 에 현시되는 도서색인파일이 있다 . 


Terms 

| Pages 

j •… sideb 的 rings 

10, 34-35, 307-308 

B- subtraction 


卜 of pictures 

115, 244 

; of vcctoro 

0 


그림 14-2. QListView 에 적재된 도서색 인파일 


<?xml version="1.0"?> 
<bookindex> 

<entry term="sidebearings"> 
<page> 10</page> 
<page>34-35</page> 
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<page>307-308</page> 

</entry> 

<entry term= M subtraction n > 

<entry term="of pictures "〉 

<page>l 15</page> 

<page>244</page> 

</entry> 

<entry term= M of vectors M > 

<page>9</page> 

</entry> 

</entry> 

</bookindex> 

문장해석기를 실현하는 첫 단계는 QXmlDefaultHandler 의 파생클라스를 만드는것이다 . 
class SaxHandler : public QXmlDefaultHandler 

{ 

public: 

SaxHandler(QListView *view); 

bool startElement(const QString &namespaceURI, const QString &localName, 
const QString &qName, const QXmlAttributes &attribs); 
bool endElement(const QString &namespaceURI, 
const QString &localName, 
const QString &qName); 

bool characters(const QString &str);bool fatalError(const QXmlParseException &exception); 
private: 

QListView *listView; 

QListViewItem *currentltem; 

QString currentText; 

}； 

Sax 처리함수클라스는 QXmlDefaultHandler 를 계승하며 4 개의 함수 startElement(), endElemen 
t(), characters(), fatalError() 를 재정의한다 . 처음 3 개 함수는 QXmlContentHandler 에서 선언되고 
마지막 함수는 QXmlErrorHandler 에서 선언된다 . 

SaxHandler: : SaxHandler(QListView * view) 


listView = view; 
currentltem = 0; 




SaxHandler 구성자는 XML 파일에 보관된 정보를 현시하려는 QListView 를 받아들인다 . 

bool SaxHandler: :startElement(const QString &, const QString &, const QString &qName, 
const QXmlAttributes &attribs) 

{ 

if (qName = "entry") { 
if (currentltem) { 

currentltem = new QListViewItem(currentltem); 

} else { 

currentltem = new QListViewItem(listView); 

} 

currentItem->setOpen(true); 
currentItem->setText(0, attribs.value("term")); 

} else if (qName = "page") { 
currentText = 

} 

return true; 

} 

startElementO 함수는 읽기프로그람이 새로운 열기꼬리표를 만날 때 호출된다 . 셋째 파라메 
터는 꼬리표이름(혹은 더 정확하게는 그《수식이름 (qualified name)》) 이다 . 넷째 파라메터는 속 
성 목록이 다 . 이 실례 에서 는 첫째와 둘째 파라메터 들을 무시한다 . 그것들은 XML 의 이 름공간 
기구를 사용하는 XML 파일에 사용할수 있다 . 

꼬리표가 <entry > 이면 새로운 QListView 항목을 창조한다 . 꼬리표가 다른 <entry > 꼬리표안 
에 겹쌓이면 새 꼬리표는 색인안의 보조항목을 정의하고 둘러싸는 항목을 표시하는 
QListViewItem 의 자식으로서 QListViewItem 을 창조한다 . 그렇지 않으면 부모로서 listView 를 가 
지는 QListViewItem 을 창조하여 그것을 제일 웃준위 항목으로 만든다 . 항목에 대하여 
setOpenCttue ) 를 호출하여 그 자식들을 표시하고 setTextO 를 호출하여 렬 0 에 표시된 본문을 
<entry > 꼬리 표의 항속성 의 값으로 설 정 한다 . 

꼬리 표가 <page > 이 면 currentText 를 빈 문자렬 로 설 정 한다 . currentText 는 </page> 

꼬리표들사이에 배치된 본문을 보관한다 . 

끝으로 仕 ue 를 돌려주어 SAX 에게 파일해석을 계속하라고 알린다 . 알려지지 않은 꼬리표 
들을 오유로서 통보하려면 false 를 돌려줄수 있다 . 또한 그때 QXmlDefauItHandler 로부터 
errorStringO 를 재정의하여 적당한 오유통보문을 돌려 준다 . 

bool SaxHandler: : characters(const QString &str) 



currentText += str; 
return true; 

} 

charactersO 함수는 XML 문서의 문자자료를 알리기 위 하여 호출된다 . 간단히 문자들을 
currentText 변수에 추가한다 . 

bool SaxHandler: : endElement(const QString &, const QString &, const QString &qName) 

{ 

if (qName = "entry") { 

currentltem = currentltem->parent(); 

} else if (qName = "page") { 
if (currentltem) { 

QString allPages = currentltem->text( 1); 
if (!allPages.isEmpty()) 
allPages += ，’,，，; 
allPages += currentText; 
currentItem->setText( 1 ， allPages); 

} 

} 

return true; 

} 

endElementO 함수는 읽기 프로그람이 닫기 꼬리표를 만날 때 호출된다 . startElementO 에서와 
같이 셋째 파라메터는 꼬리표이름이다 . 

꼬리 표가 </entry> 0 l 면 currentltem 비 공개 변수를 갱신하여 현재 QListViewItem 의 부모를 가 
리킨다 . 이것은 currentltem 변수가 대응하는 </entry> 꼬리표를 읽기전에 보관한 값을 되살리도 
록 한다 . 

꼬리 표가 </page> 이 면 지 정된 폐지번호를 추가하거 나 1 렬 현재 항목의 본문에서 반점으로 
구분된 목록까지의 폐지범위를 추가한다 . 

bool SaxHandler: : fatalError(const QXmlParseException &exception) 

1 

qWaming("Line %d, column %d: %s", exception.lineNumber(), exceptionxoluirmNumber(), 
exception.message().ascii()); 
return false; 

} 

fatalErrorO 함수는 읽기프로그람이 XML 파일의 문장해석에서 실폐할 때 호출된다 . 이런 일 
이 생기 면 단순히 행 번호，렬번호 , 문장해석기 의 오유를 주는 경 고를 출력한다 . 
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이로서 Sax 처리함수클라스의 실현을 끝낸다 . 그러면 클라스의 사용방법을 고찰하자 . 

bool parseFile(const QString &fileName) 

{ 

QListView *listView = new QListView(O); 

listView->setCaption(QObject::tr("SAX Handler")); 

listView->setRootIsDecorated(true); 

listView->setResizeMode(QListView::AllColumns); 

listView->addColumn(QObject::tr( n Terms n )); 

listView->addColumn(QObject::tr( n Pages")); 

listView->show(); 

QFile file(fileName); 

QXmlSimpleReader reader; 

SaxHandler handler(listView); 
reader.setContentHandler(&handler); 
reader.setErrorHandler(&handler); 
return reader.parse(&file); 

} 

2 개 렬 을 가지 도록 QListView 을 설 정한다 . 그다음 읽 으러 는 파일 용으로 QFile 객 체 를 창조 
하고 파일을 해석하려는 QXmlSimpleReader 를 창조한다 . QFile 을 자체로 열 필요는 없고 Qt 가 
자동적으로 연다 . 

끝으로 SaxHandler 객체를 창조하고 그것을 읽기 프로그람에 대하여 내용처리함수와 오유처 
리함수의 두 처 리 함수로 설 치 하고 읽 기 프로그람에 대 하여 parse 。 를 호출하여 문장해 석 을 수 
행 한다 . 

SaxHandler 에서는 오직 QXmlContentHandler 와 QXmlError 처리함수클라스로부터 함수들을 
재정의한다 . 다른 처리함수클라스로부터 함수들을 실현하였다면 읽기기구에 대하여 대응하는 
설정함수들을 호출해야 한다 . 


제2절. DOM 에 의한 XML 읽기 

DOM 은 W3C(World Wide Web Consortium ) 에 의해 개발된 XML 해석용 표준 API 이다 . 어는 
XML 문서 들을 읽 고 조작하고 쓰기 위한 비 합법 적 인 DOM 준위 2 실 현 을 제 공한다 . 

DOM 은 XML 파일을 기억기에 나무로 표시한다 . 필요할 때 DOM 나무를 항행할수 있고 나 
무를 수정하여 디스크에 XML 파일로 보관할수 있다 . 

다음과 같은 XML 문서 를 고찰하자 . 

<doc> 


<quote>Errare humanum est</quote> 
<translation>To err is human</translation> 




</doc> 

이것은 다음의 DOM 나무에 대응한다 . 


Document 

I— Element (doc) 


-Element (qu 
I ― Text ( 


(quote) 

(“Errare humanum esT) 
Element (translation) 

I — Text (To err is human'*) 


DOM 나무는 각이한 형 의 마디 들을 포함한다 . 례 를 들면 Element 마디 는 열 기 꼬리 표와 그 
와 짝을 이루는 닫기꼬리표에 대응한다 . 꼬리표들사이에 놓이는 자료는 Element 마디의 자식마 
디들로 표시된다 . 

(가에서 마디형 들은 다른 모든 DOM 관련클라스들처 럼 QDom 앞붙이 를 가전다 . 이 리 하여 
QDomElement 는 Element 마디 를 , QDomText 는 Text 마디 를 각각 표시 한다 . 

각이한 형의 마디들은 각종 자식마디를 가질수 있다 . 례를 들면 Element 마디는 다른 
Element 마디 들과 또한 EntityReference, Text, CDATASection, Processinglnstruction 그리 고 Comment 
마디들을 포함할수 있다 . 그림 14-3 은 어느 마디들이 어떤 종류의 자식마디들을 가지는가 지 
적한다 . 재 색 으로 표시 된 마디 들은 자체 의 자식 마디 를 가질 수 없 다 . 


Document Attr 


__ i _ 

A 

__ k _ 

一ᄀ 

1 

― 1 

Element 


Document 

Type 


Processing 

Instructioo 


Comment 


Entity 

Roferonco 


Text 


1 
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Fragment 


Element 
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Reference 


Efltity 

1 





_ 1 
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Elemerr 
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CDATA 

Sivrtinn 


Processing 
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그림 14-3. DOM 마디 들사이 의 부자관계 

DOM 을 리용하여 XML 파일을 읽는 방법을 설명하기 위하여 앞 절에서 서술한 도서색인 
파일형식용의 문장해석 기 를 쓴다 . 
class DomParser 
{ 

public: 

DomParser(QIODevice * device, QListView *view); 
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private: 

void parseEntry(const QDomElement &element, QListViewItem ^parent); 

QListView *listView; 

}； 

도서색인 XML 문서를 해석하는 DomParser 라는 클라스를 정의하고 QListView 에 결과를 현 
시한다 . 이 클라스는 다른 클라스를 계승하지 않는다 . 

DomParser: : DomParser(QIODevice *device, QListView *view) 

{ 

listView = view; 

Q String errorStr; 
int errorLine; 
int errorColumn; 

QDomDocument doc; 

if (! doc.setContent(device, true, &errorStr, &errorLine, &errorColumn)) { 

qWaming("Line %d, column %d: %s", errorLine, errorColumn, errorStr.ascii()); 
return; 

} 

QDomElement root = doc.documentElement(); 
if (root.tagName() != "bookindex") { 

qWaming( M The file is not a bookindex file’’); 
return; 

} 

QDomNode node = root.firstChild(); 
while (!node.isNull()) { 

if (node.toElement().tagName() == "entry”) 
parseEntry(node.toElement(), 0); 
node = node .nextS ibling(); 

} 

} 

구성자에서는 QDomDocument 객체를 창조하고 그것에 대하여 setContentf} 를 호출하여 
QIODevice 가 제공하는 XML 문서를 읽어들인다 . setContentO 함수는 장치가 이미 열려져 있지 
않으면 그것을 자동적으로 연다 . 그다음 QDomDocument 에 대하여 documentElement () 를 호출하 
여 하나의 QDomElement 자식을 얻고 그것이 <bookindex 〉 요소인가 검사한다 . 그다음 모든 자식 
마디 들을 순환하면서 마디 가 <entry > 요소이 면 parseEntryO 를 호출하여 해석한다 . 

QDomNode 클라스는 임의의 형의 마디를 보관할수 있다 . 마디를 더 처리하려고 한다면 우 




선 마디를 정확한 자료형으로 변환해야 한다 . 이 실례에서는 오직 Element 마디들만 고찰하므 
로 QDomNode 에 대하여 toElement () 를 호출하여 QDomElement 로 변환한 다음 tagName () 을 호 
출하여 요소의 꼬리표이름을 엄는다 . 마디가 Element 형 이 아니면 toElement () 함수는 빈 꼬리표 
이름을 가지는 빈 QDomElement 객체를 돌려준다 . 

void DomParser: : parseEntry(const QDomElement &element, QListViewItem *parent) 

{ 

QListViewItem *item; 
if (parent) { 

item = new QListViewltem(parent); 

} else { 

item = new QListViewItem(listView); 

} 

item->setOpen(true); 

item->setText(0, element.attribute("term n )); 

QDomNode node = element. firstChild(); 
while (!node.isNull()) { 

if (node.toElement().tagName() == "entry") { 
parseEntry(node.toElement(), item); 

} else if (node.toElement().tagName() == ’’page") { 

QDomNode childNode = node.firstChild(); 
while (! childNode.isNull()) { 

if (childNode.nodeType() == QDomNode :: TextNode) { 

QString page = childNode.toText().data(); 

QString allPages = item->text(l); 
if (!allPages.isEmpty()) 
allPages += ", 
allPages += page; 
item->setText( 1, allPages); 
break; 

} 

childNode = childNode ,nextSibling(); 

} 

} 

node = node .nextS iblingQ; 



parseEntryO 에서는 QListView 항목을 창조한다 . 꼬리표가 다른 <entry> 꼬리표안에 겹쌓이면 
새 꼬리표는 색인안의 보조항목을 정의하고 둘러싸고있는 항목을 표시하는 QListViewItem 의 
자식으로서 QListViewItem 을 창조한다 . 그렇지 않으면 부모로서 listView 를 가지는 
QListViewItem 을 창조하여 그것 을 제 일 웃준위 항목으로 만든다 . 그 항목에 대 하여 
setOpen(ttue) 를 호출하여 보조항목을 볼수 있도록 하며 se 付 ext() 를 호출하여 렬 0 에 표시된 본 
문을 <entry> 꼬리 표의 term 속성 값으로 설 정 한다 . 

QListViewItem 을 초기화한 다음 현재 <entry> 꼬리표에 대응하는 QDomElement 마디의 자식 
마디들을 순환한다 . 

요소가 <entry> 이면 현재 항목을 둘째 인수로 하여 parseEntryO 를 호출한다 . 그때 새 항목 
의 QListViewItem 은 둘러싸인 항목의 QListViewItem 을 부모로 하여 창조된다 . 

요소가 <page> 이면 요소의 자식목록을 항행하여 Text 마디를 찾는다 . 그것을 발견하였으면 
toText() 를 호출하여 QDomText 객체로 변환하고 data() 를 호출하여 본문을 QString 으로서 꺼낸다 . 
그다음 그 본문을 QListViewItem 의 렬 1 안에서 반점으로 구분한 목록에 추가한다 . 

그러면 DomParser 클라스에 의 하여 파일을 해석하는 방법을 고찰하자 . 

void parseFile(const QString &fileName) 

{ 

QListView * listView = new QListView(O); 

listView->setCaption(QObject: : tr("DOM Parser")); 

listView->setRootIsDecorated(true); 

listView->setResizeMode(QListView::AllColumns); 

listView->addColuimi(QObject::tr( M Terms n )); 

listView->addColumn(QObject::tr( M Pages n )); 

listView->show(); 

QFile file(fileName); 

DomParser(&file, listView); 

} 

QListView 의 설정으로 시작한다 . 그다음 QFile 과 DomParser 를 창조한다 . DomParser 가 구성 
될 때 파일을 해석하고 목록보기를 채운다 . 

실례 에서 설명 하는것처 럼 DOM 나무항행은 귀찮을수 있다 . 守& § 心와 </page> 사이 의 본문을 
간단히 발취하려면 firstChildO 와 nextSiblingO 을 리용하여 QDomNodes 목록을 순환할것을 요구 
한다 . DOM 을 많이 사용하는 프로그람작성자들은 꼬리표들사이의 본문을 꺼내는것과 갈은 일 
반적 으로 필요한 조작을 단순화하기 위 하여 자체 의 고수준래 퍼 함수들을 작성한다 . 

제3절. XML 쓰기 

Qt 응용프로그람들로부터 XML 파일들을 생성하는데 기본적으로 2 가지 수법이 있다 . 





•DOM 나무를 구축하고 그것에 대하여 save() 를 호출한다 . 

• 코드를 작성 하여 XML 을 생 성할수 있 다 . 

이 수법들사이의 선택은 흔히 별도문서들을 읽어들이는데 SAX 를 사용하는가 DOM 을 사 
용하는가에 의존한다 . 

여기에 DOM 나무를 창조하고 QTextS 仕 earn 에 의하여 그것을 써넣는 방법을 설명하는 코드 
부분이 있다 . 

const int Indent =■ 4; 

QDomDocument doc; 

QDomElement root = doc.createElement( ,, doc M ); 

QDomElement quote = doc.createElement( n quote"); 

QDomElement translation = doc.createElement("translation"); 

QDomText quoteText = doc.createTextNode("Errare humanum est"); 

QDomText translationText = doc.createTextNode("To err is human"); 

doc.appendChild(root); 

root.appendChild(quote); 

root.appendChild(translation); 

quote.appendChild(quoteText); 

translation.appendChild(translationText); 

QTextStream out(&file); 
doc.save(out, Indent); 

saveO 의 둘째 인수는 사용하려는 들여쓰기를 나타낸다 . 들여쓰기의 크기는 0 아닌 값으로 
설정하면 사람들이 파일을 읽기 쉽다 . 여기에 XML 파일출력이 있다 . 

<doc> 


<quote>Errare humanum est</quote> 
<translation>To err is human</translation> 


</doc> 

다른 대본은 DOM 나무를 기본자료구조로 사용하는 응용프로그람들에 있다 . 이려한 응용 
프로그람들은 보통 DOM 을 리 용하여 XML 문서 들을 읽어 들인 다음 기 억 기 에서 DOM 나무를 
수정하고 끝으로 saveO 를 호출하여 나무를 XML 로 변환한다 . 

우의 실례 에서는 부호화로서 UTF-8 을 사용한다 . DOM 나무에 
<?xml version="1.0" encoding="ISO-8859 -1 "?> 

를 종속시킴으로써 다른 부호화를 사용할수 있다 . 다음의 코드부분은 이것을 수행하는 방법 
을 보여준다 . 

QTextStream out(&file); 

QDomNode xmlNode = 




doc.createProcessingInstruction("xmr , , M version=\ M 1 .( 八 " encoding=\"ISO-8859-1\""); 
doc.insertBefore(xmlNode, doc.firstChild()); 
doc.save(out, Indent); 

수동적으로 XML 파일들을 생성하여 DOM 을 리용하는것보다 힘들지 않다 . QTextStream 을 
리용하여 문자렬들을 임의의 본문파일에 대하여 수행한것처럼 써넣을수 있다 . 가장 엄격한 
부분은 본문과 속성값들에서 특수문자들을 확장하는것이다 . 개별적인 함수에서 이것을 수행 
할수 있다 . 

QString escapeXml(const QString &str) 

{ 

QString xml = str; 
xml.replace( n &", M &amp; M ); 
xml.replace("<", 
xml.replace(">", 
xml.replace( MM, , M &apos ; n )； 
xml.replace("\ … ， , ，， &quot;，，); 
return xml; 

} 

여기에 그것을 사용하는 실례가 있다 . 

QTextStream out(&file); 
out.setEncoding(QTextStream::UnicodeUTF8); 

out « ”<doc>\n" « " <quote> M « escapeXml(quoteText) « M </quote>\n" 

« " 〈 translation〉’’ « escapeXml(translationText) « ，， </translation>\n" « "</doc>\n" 





제 15 장. 국제화 


이 장에서는 영어가 아닌 언어로 Qt 응용프로그람들을 쓰는 방법과 현존 Qt 응용프로그람을 
다른 언어로 번역하는 방법을 설명한다 . 

1 절에서는 Qt 의 원시문자부호화인 유니코드를 론한다 . 영어사용자대면부를 가지는 응용프 
로그람도 어느 날에는 우리글이나 그리스문으로 된 사용자의 콤퓨터에서 실행할수 있으므로 
이 절에서 나오는 내용은 모든 Qt 개발자들이 알아야 한다 . 

2 절에서는 응용프로그람들의 번역준비방법을 보여준다 . 이 과정은 너무 간단하므로 자기 
쏘프트웨어의 번역 판을 제공할 계획을 가지지 않는 경우에도 수행 할만한 가치 가 있다 . 이 것 
은 번역기를 빌리여 후날에 자기 응용프로그람용의 새로운 시장을 창조할 좋은 기회를 준다 . 

3 절은 진짜 국제적인 응용프로그람들을 목적하여 실행중에 응용프로그람이 언어를 변경 
하게 하는 방법을 보여준다 . 

마지 막 절 은 번 역 과정 을 모두 서 술한다 . 또한 Qt Linguist 와 어의 다른 번 역 도구들을 리용 
하여 프로그람작성자와 번역기들이 함께 작업하는 방법을 보여준다 . 

제1절. 유니코드와의 작업 

유니 코드는 세계의 대 다수 문서 체계를 유지 하는 문자부호화표준이 다 . 유니 코드에 은폐되 
여있는 원래의 사상은 문자보관에 8bit 대신 16bit 를 사용하여 256 문자대신에 65000 개의 문자들 
을 부호화하는것이 였다 . 유니 코드는 ASCII 와 ISO 8859- 1 (Latin-1 ) 을 같은 코드위 치 에서 부분모 
임으로 포함한다 . 례를 들면 문자 ’A ’ 는 ASCII 와 Latin- 1, 유니 코드에서 값 0x41 을 가지고 문자 
V 는 Latin-1 과 유니코드량쪽에서 값 OxDF 을 가진다 . 

Qt 의 QString 클라스는 문자렬들을 유니코드로 보관한다 . QStting 안의 매개 문자는 8bit char 
가 아니라 16bitQChar 이다 . 여기에 문자렬의 첫 문자를 ’A ’ 로 설정하는 2 가지 방법이 있다 . 
str[0] = 'A'; 

的 i 功 = QChar(0x41); 

원 천 파일 이 Latin-1 로 부호화되 면 Latin-1 문자지 정 은 아주 간단하다 . 

加[이 = V; 

그리고 원천파일이 다른 부호화를 가지면 수값은 제대로 작업한다 . 

加[이 = QChar(OxDF); 

임의의 유니코드문자를 그 수값으로 지정할수 있다 . 례를 들면 여기에 그리스대문자 시그 
마 ( 방)와 유로화폐기호(’ €’) 를 지정하는 방법이 있다 . 
str[0] = QChar(0x3A3); 
str [이 = QChar(0x20AC); 

드문히 Latin-1 이 아닌 유니코드문자들이 요구되면 문자탐색은 직결로 충분히 할수 있다 . 
그러 나 어는 Qt 프로그람에 유니 코드문자렬들을 입 력 하는 더 편리한 수법 을 제공한다 . 그것 을 



이 절에서 후에 설명한다 . 

Qt 3. 2 의 본문엔진은 모든 가동환경 에서 다음과 같은 문서체계들을 유지한다 . 아랍어，중 
국어，씨릴어，그리스어，헤브라이 , 일본어，조선어，라오스어 , 라린어，타이어，및 월남어 . 또한 
특수한 처리를 요구하지 않는 모든 유니코드 3.2 스크립트들도 요구한다 . 게다가 다음의 문서 
체계들은 Xft 을 사용하는 XII 과 NT 기초의 Windows 판들에 유지된다 . 즉 뱅갈어， Devanagari, 
Gujarati, Gurmukhi, Kannada, Khmer, 수리 아어，타밀 어， Telugu, Thaana. 끝으로 Malayalam 과 리 베 
트어를 XII 에 유지하고 Divehi 를 Windows XP 에 유지 한다 . 체계에 적당한 서체들이 설치된다 
고 가정 하면 어는 이 려 한 문서체 계 중의 어 느것 이 나 사용하여 본문을 그릴 수 있다 . 그리 고 적 
당한 입 력방법 이 설치 된다고 가정 하면 사용자들은 Qt 응용프로그람들에서 이 려 한 문서체계들 
을 사용하는 본문을 입 력할수 있 다 . 

QChar 를 사용하는 프로그람작성은 char 를 사용하는 프로그람작성과 아주 다르다 . QChar 의 
수값을 얻으러면 그에 대하여 unicode() 를 호출한다 . QChar 의 ASCII 혹은 Latin- 1 값 (char) 을 얻 
으려 면 latinlO 을 호출한다 . Latin-1 이 아닌 문자들에 대하여 latinl() 은 0 을 돌려준다 . 

프로그람안의 모든 문자별들이 ASCII 혹은 Latin-1 이라는것을 알고있으면 

isalpha(), isdigit(), isspace() 와 같은 표준 <cctype> 함수들을 사용할수 있다 . 이것들은 QString 들이 
자동적 으로 const char * 로 변환되 듯이 QChars 가 정 확한 문맥으로 주어 진 char (Latin-1) 들로 자 
동변환되 므로 제 대로 작업한다 . 그러 나 일반적 으로 이 려 한 조작을 수행하는데 QChar 의 성 원 
함수들을 사용하는것이 더 좋다 . 그것은 QChar 의 성원함수들이 임의의 유니코드문자들에 대 
하여 작업하기때문이다 . QChar 가 제공하는 함수에는 isPrint(), isPunct(), isSpace(), isMark(), isLe 
tter(), isNumber(), isLetterOrNumber(), isDigit(), isSymbol(), lower(), upper() 가 있다 . 례를 들면 여 
기에 문자가 수자인가 대문자인가를 시험하는 방법이 있다 . 
if (ch.isDigit() || ch; _ ch.lower()) ... 

lower() 함수는 소문자판의 문자를 돌려준다 . 문자의 소문자판이 문자자체와 다르면 그 문 
자는 대문자이여 야 한다 . 코드부분은 라린 어，그리스어，시릴어를 비롯한 대소문자를 구별하 
는 임 의의 자모에 대하여 작업한다 . 

QStting 을 요구하는 Qt 의 API 는 모두 유니코드문자렬을 사용할수 있다 . 그때 유니코드문 
자렬을 적당히 현시하고 조작체계와 대화할 때 다른 부호화로 변환하는것 이 여의 응답능력 이 
다 . 

본문파일들을 읽고 쓸 때에는 특별한 주의가 필요하다 . 본문파일들은 여러가지 부호화를 
사용하며 그 문맥으로부터 본문파일의 부호화를 알아낼수는 없다 . 기정으로 QTextStream 은 읽 
기와 쓰기에 대하여 QTextCodec::codecForLocale() 에서 유효한 체계의 국부 8bit 부호화를 사용한 
다 . 미 국과 서 유럽 지 역 에서 이 것은 Latin-1 을 의 미한다 . 

자체의 파일형식을 설계하고 임의의 유니코드문자를 읽고 쓰게 하려면 QTextStream 에 써 
넣 기를 시 작하기전에 setEncoding(QTextStream::Unicode)l- 호출하여 자료를 유니코드로 보관할 
수 있다 . 그때 자료는 문자당 2byte 를 요구하는 형식인 UTF-16 으로 보관된다 . UTF-16 형식은 




QString 의 기억기표시와 아주 근사하므로 유니코드문자털들을 UTF-16 으로 읽고쓰는 속도는 
아주 빠르다 . 그러나 순수 ASCII 자료를 UTF-16 형식으로 보관할 때 매개 문자를 lbyte 대신에 
2byte 로 보관하므로 추가비용이 든다 . 

본문을 읽어들일 때 QTextStteam 은 보통 유니코드를 자동적으로 탐지하지만 절대적인 확 
신을 위하여 읽 기 전에 setEncoding(QTextStteam::Unicode) 를 호출하는것 이 제 일 좋다 . 

유니 코드전체 를 유지 하는 다른 부호화는 UTF-8 이 다 . UTF16 에 비한 UTF-8 의 우점 은 그것 
이 ASCII 의 웃준위모임이라는것이다 . 범위 0x00 〜 0x7F 의 임의의 문자는 lbyte 로 표시된다 . 
0x7F 이상의 Latin-1 문자들을 포함하는 다른 문자들은 여러바이트렬로 표시된다 . 대체로 ASCII 
인 본문에 서 UTF-8 은 UTF-16 이 소비 하는 공간의 약 절 반을 차지 한다 . UTF-8 을 QTextStteam 에 
서 사용하려면 읽고쓰기 전에 setEncoding(QTextS 仕 eam :: UnicodeUTF8) 를 호출해야 한다 . 

사용자의 지역에 관계없이 늘 Latin-1 을 읽고써넣으려고 한다면 QTextS 仕 earn 에 대하여 
setEncoding(QTextS 仕 eam::Latinl) 을 호출할수 있다 . 

적 당한 QTextCodec 를 리 용하여 setCodecO 를 호출함으로써 다른 부호화를 지 정 할수 있다 . 
QTextCodec 는 유니 코드와 주어 진 부호화사이 를 변환하는 객 체 이 다 . QTextCodec 는 여 러 가지 문 
맥에서 Qt 에 의해 사용된다 . 내적으로 QTextCodec 는 서체，입력메쏘드 , 오려둠판 , 끌어다놓기， 
파일이름들을 유지하는데 쓰인다 . 그러나 Qt 응용프로그람을 쓸 때에도 사용할수 있다 . 

례를 들면 EUC-KR 부호화로서 파일을 읽어 들이 려 고 한다면 다음과 같이 쓸수 있다 . 

QTextStream in(&file); 

QTextCodec *koreanCodec = QTextCodec: :codecForName(’’EUC-KR"); 

if (koreanCodec) 
in. setCodec(koreanCodec); 

일부 파일형식들은 머리부에서 부호화를 지정한다 . 일반적으로 머리부는 평본문 ASCII 로 
함으로써 어 떤 부호화를 사용하는가에 관계 없 이 정 확히 읽어 들이 도록 한다 . (그것 이 ASCII 의 
웃준위모임이라고 가정한다 .；) XML 파일형식은 그러한 실례의 하나이다 . XML 파일들은 보통 
UTF-8 이 나 UTF-16 로 부호화된다 . 그 파일들을 읽 어 들이 는 적 당한 수법 은 
setEncoding(QTextS 仕 eam::UnicodeUTF8) 을 호출하는것이다 . 형식이 UTF-16 이면 QTextS 仕 earn 는 
자동적으로 이것을 탐지하고 자체로 조절한다 . XML 파일의 <?xml?> 머리부는 흔히 부호화인수 
를 포함한다 . 례를 들면 

<?xml version="1.0" encoding="EUC-KR"?> 

일단 읽기 시작하면 QTextStteam 이 부호화를 변경하지 못하게 하므로 명시적인 부호화를 
고려 하는 옳은 방법 은 정 확한 부호災 TextCodec :: codecForName() 로부터 얻어 진다.)를 사용하여 
그 파일을 다시 읽기 시작하는것이다 . 

XML 의 경우에는 14 장에서 서술하는 (가의 XML 클라스들을 사용하여 자체로 부호화를 처 
리 하는것 이 다 . 

또 하나의 QTextCodec 사용은 원천코드에서 발생하는 문자렬들의 부호화를 지정하는것이 



다 . 일본의 가정용시장을 주로 목표로 삼은 응용프로그람들을 작성하는 일본어 프로그람작성 
자림의 실례를 고찰하자 . 이러한 프로그람작성자들은 EUC-JP 혹은 Shift-JIS 와 같은 부호화를 
사용하는 본문편집기에서 자기의 원천코드를 쓰고싶어한다 . 그러한 편집기는 원천코드를 일 
본어로 원만히 입력하게 하므로 다음과 같이 코드를 쓸수 있다 . 

QPushButton *button = new QPushButton(tr(" 0 0); 

기정으로 (가는 仕 () 의 인수들을 Latin-1 로 해석한다 . 이것을 변경하려면 QTextCodec: : setCode 
cForTrO 정 적 함수를 호출해 야 한다 . 례 를 들면 

QTextCodec *japaneseCodec = QTextCodec::codecForName("EUC-JP ")； 

QTextCodec :: setCodecForTr(j apaneseCodec); 

이것은 처음으로 tr() 를 호출하기전에 수행되여야 한다 . 일반적으로 mainO 에서 

(^Application 객 체 를 창조한 직 후에 수행할수 있다 . 

프로그람에서 지정된 다른 문자렬들은 여전히 Latin-1 문자렬로 해석된다 . 프로그람작성자 
들이 문자렬들에 일본어문자를 입력하려고 한다면 QTextCodec 를 사용하여 문자들을 명시적으 
로 유니코드로 변환할수 있다 . 

QString text = japaneseCodec->toUnicode ("'■■科 

또한 QTextCodec::setCodecForCS 仕 ings() 를 호출하여 const char *와 QString 사이를 변환할 때 
특수부호를 사용하도록 어에 요구할수 있다 . 

QTextCodec :: setCodecForCS 仕 ings(j apaneseCodec) ; 

Qt 의 내부는 흔히 ASCII 문자렬을 QString 으로 변환하므로 부호화는 ASCII 의 웃준위모임 
이 여 야 한다 . 

우에서 서술한 기술은 중국어 , 그리스어 , 조선어 , 로어를 비롯하여 임의의 Latin-1 이 아닌 
언어에 적용할수 있다 . 

여기에 Qt3.2 가 유지하는 부호화의 목록이 있다 . 


Apple Roman CP 1258 

ISO 

8859-4 

ISO 8859-15 

Big5-HKSCS EUC-JP 

ISO 

8859-5 

ISO 10646 

CP874 

EUC-KR 

ISO 

8859-6 

UCS-2 

CP1250 

GB2312 

ISO 

8859-7 

JIS7 

CP1251 

GB18030 

ISO 

8859-8 

K018-R 

CP1252 

GBK 

ISO 

8859-8-1 

KOI8-U 

CP1253 

IBM-850 

ISO 

8859-9 

Shift-JIS 

CP1254 

IBM-866 

ISO 

8859-10 

TIS-620 

CP1255 

ISO 8859-1 

ISO 

8859-11 

TSCII 

CP1256 

ISO 8859-2 

ISO 

8859-13 

UTF-8 

CP1257 

ISO 8859-3 

ISO 8859-14 



이 모두에 대 하여 QTextCodec::codecForName() 는 늘 유효지적 자를 돌려 준다 . QTextCodec 의 







파생클라스를 만들거나 문자략도 (charmap) 파일을 창조하고 QTextCodec::loadCharmapFile() 을 사 
용함으로써 다른 부호화들을 유지할수 있 다.(자세 한 내 용은 QTextCodec 방조를 참고하시 오 .：) 

제2절. 번역을 인식하는 음용프로그람 만들기 

다국어를 사용할수 있는 응용프로그람을 만들려고 한다면 다음의 2 가지를 수행해야 한다 . 

• 사용자에게 보여주려는 문자렬이 더)안에 들어있는가 확인한다 . 

• 기동시에 번역 (.qm) 파일을 적재한다 . 

번역하지 않는 응용프로그람들에는 이것이 필요없다 . 그러나 trO 사용은 거의 품을 들이지 
않고 후날에 번역을 진행하기 위한 문을 열수 있게 한다 . 

tr() 함수는 QObject 에서 정의된 정 적함수이고 Q_OBJECT 마크로로 정의된 모든 파생클라스 
에서 재정의된다 . QObject 파생클라스안에서 코드를 쓸 때에는 형식이 없이 trO 를 호출할수 있 
다 . 仕 0 호출은 번역이 유효이면 번역문을 돌려주고 그렇지 않으면 원래의 본문을 돌려준다 . 

번역파일들을 준비하려면 Qt 의 lupdate 도구를 실행하여야 한다 . 이 도구는 tr() 호출에 나타 
나는 문자렬상수들을 모두 꺼 내서 이 문자렬들을 모두 포함하고 번역할 준비가 되 여있는 번 
역파일을 생성한다 . 그때 파일들은 번역기에 보내지고 추가된 번역문을 가지게 된다 . 이 과정 
은 4 절 《응용프로그람의 번 역》에서 설명한다 . 

trO 호출은 다음과 같은 일반문법을 가진다 . 

Gontsxty. 仕 (^sourvclbxt, comment) 

Qwtex/ 부분은 Q_OBJECT 마크로에 의해 정의된 QObject 의 파생클라스이름이다 . 문제로 되 
여있는 클라스의 성원함수로부터 trO 를 호출한다면 그 마크로를 지정할 필요가 없다 . 
■sowrceTfert 부분은 번역해야 할 문자렬상수이다 . comme 까부분은 선택적이고 번역기에 추가정보 
를 제공하는데 쓰인다 . 

여기에 몇가지 실례가 있다 . 

Blue Widget: : BlueWidget(QWidget *parent, const char *name) : QWidget(parent, name) 

{ 

QString 仕 ("Legal”); 

QString s 仕 2 = BlueWidget::tr("Legal ")； 

QString s 仕 3 = YellowDialog:: 仕 ("Legal"); 

QString str4 = YellowDialog:: 仕 ("Legal", "US paper size"); 

} 

tr() 의 첫 호출은 문맥으로서 Blue Widget 를 가지며 마지막 2 개의 호출은 YellowDialog 를 가 
진다 . 4 개 모두가 Legal 을 원천본문으로 가진다 . 마지막 호출도 번역기가 원천본문의 의미를 
리해 하도록 방조하기 위 한 설 명 문을 가진 다 . 

각이한 문맥 ( 클라스 ) 의 문자털들은 서로 독립적으로 번역된다 . 보통 번역기들은 흔히 번 
역해야 할 창문부품이나 대화칸을 실행하고 표시하는 응용프로그람에서 한번에 하나의 문맥 
에 대하여 작업한다 . 



대 역함수로부터 trO 를 호출할 때 문맥을 정확히 지정해 야 한다 . 응용프로그람안의 임의의 
QObject 파생클라스를 문맥으로 사용할수 있다 . 적당한것이 없으면 늘 QObject 자체를 사용할수 
있다 . 례를 들면 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 


QPushButton button(QObject::tr("Hello Qt!"), 0); 

app.setMainWidget(&button); 

button. show(); 

return app.exec(); 

} 

이려한 수법을 응용프로그람의 이름을 번역하는데 사용할수 있다 . 이름을 여러번 입력하 
고 번역기가 이름이 나타나는 매개 클라스에 대하여 그것을 번역하게 하는것이 아니라 번역 
된 응용프로그람이름으로 전개하는 APPNAME 마크로를 정의하여 응용프로그람의 모든 파일 
에 포함되는 머리부파일에 마크로를 넣는것이 일반적으로 더 편리하다 . 

#define APPNAME MainWindow::tr("OpenDrawer 2D") 

지금까지의 실례에서 문맥은 클라스이름이였다 . 이것은 대체로 클라스이름을 생략할수 있 
으므로 편리하지만 늘 그런것은 아니다 . Qt 에서 문자렬을 번역하는 가장 일반적인 방법은 
(^Applications:: 仕 anslate() 함수를 사용하는것이다 . 이 함수는 3 개 인수 즉 문맥，원천본문，설명문 
의 선택을 받아들인다 . 례를 들면 여기에 APPNAME 을 정의하는 다른 방법이 있다 . 

#define APPNAME qApp->translate("Global Stuff', "OpenDrawer 2D") 

이 번 에는 본문을 ’’Global Stu 任'’문맥 에 넣는다 . 

tr() 와 translateO 함수는 2 중목적에 쓰인다 . 즉 이 함수들은 lupdate 가 사용자에게 보여 주는 
문자렬들을 찾는데 사용되는 표식기인 동시에 본문을 번역하는 C++ 함수들이다 . 이것은 코드 
작성방법에 영향을 준다 . 례를 들면 다음의 코드는 동작하지 않는다 . 

// WRONG 

const char *appName = "OpenDrawer 2D"; 

QString translated = tr(appName); 

여기서 문제는 ’’OpenDrawer 2D” 문자렬상수가 tr() 호출안에 나타나지 않으므로 lupdate 가 꺼 
낼수 없는것이다 . 이것은 번역기가 문자렬을 번역할 기회를 모른다는것을 의미한다 . 이 문제 
는 흔히 동적문자렬과 관련하여 제기된다 . 

// WRONG statusBar()->message(tr("Host " + hostName + ’’ found")); 

여기서 tr() 에 넘기는 문자렬은 hostName 의 값에 의존하므로 tr() 가 그것을 정확히 번역하 
리라고 기대할수 없다 . 



해결책은 QString :: argO 를 사용하는것이다 . 

statusBar()->message(tr("Host %1 found") .arg(hostName)); 

그 동작을 알아두자 . 문자렬상수 "Host %1 found " 가 trO 에 넘 어 간다 . 프랑스어 번 역 파일을 
적재하였다고 가정하면 仕 () 는 "Hote %1 trouv6 " 와 같은것을 돌려준다 . 그때 "%1" 파라메터는 
hostName 변수의 내용으로 교체된다 . 

일반적으로 변수에 대하여 tr () 호출을 가능하게 하려면 QT_TR_NOOP () 마크로를 사용하여 
문자렬상수들을 변수에 대 입하기전에 번역용으로 표식한다 . 이것은 문자렬들의 정적배 렬에 
가장 쓸모있다 . 례를 들면 
void OrderForm::init() 

{ 

static const char * const flowers[] *--|; 

QT_TR_NOOP("Medium Stem Pink Roses"), QT_TR_NOOP("One Dozen Boxed Roses"), 
QT_TR_NOOP("Calypso Orchid"), QT_TR_NOOP("Dried Red Rose Bouquet"), 
QT_TR_NOOP("Mixed Peonies Bouquet"), 0 

}； 

int i = 0; 

while (flowers[i]) | 

comboB ox->insertItem (仕 (flower s [i])) ;++i;} 

} 

QT_TR_NOOP() 는 단순히 그 인수를 돌려준다 . 그러나 lupdate 는 QT_TR_NOOP() 에 포함되 
는 모든 문자별들을 꺼 내 므로 문자털 들을 번 역할수 있다 . 후에 변 수를 사용할 때 仕 () 를 호출 
하여 보통처럼 번역을 수행한다 . 지어는 tr() 에 변수를 넘기였다 할지라도 번역은 여전히 진행 
된 다 . 

또한 QT_TR_NOOP () 처럼 작업 하지만 문맥을 가지는 QT_TRANSLATE_NOOP () 마크로가 
있다 . 이 마크로는 클라스밖에서 변수들을 초기화할 때 쓸모있다 . 
static const char * const flowers[] = | 

QT_TRANSLATE_NOOP( ,, OrderForm ,, ? "Medium Stem Pink Roses"), 
QT_TRANSLATE_NOOP ( ， ’ OrderForm", "One Dozen Boxed Roses"), 
QT_TRANSLATE_NOOP("OrderF()mi"，"Calypso Orchid"), 
QT_TRANSLATE_NOOP( n OrderForm n , "Dried Red Rose Bouquet"), 
QT_TRANSLATE_NOOP( ,, OrderForm M , "Mixed Peonies Bouquet"), 

}； 

context 인수는 후에 tr() 혹은 仕 anslateQ 에 주어지는 문맥과 같아야 한다 . 
trO 를 응용프로그람에서 사용하기 시작할 때 사용자가 볼수 있는 문자렬들을 trO 호출안에 
넣는것을 잊기 쉽다 . 특히 처음 사용할 때는 더하다 . tr () 호출을 빠뜨린것들은 우연히 번역기가 
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혹은 번역된 응용프로그람의 사용자들이 발견하며 그때 일부 문자렬들은 원래 언어로 나타난 
다 . 이 문제 를 피 하기 위 하여 Qt 에 const char *로부터 QStting 에 로의 암시 적변 환을 금지 하도록 
<qstring.h>l - 포함하기 전에 QT_NO_CAST_ASCII 앞처 리 기 기호를 정의 함으로써 이 것을 수 
행한다 . 이 기호를 담보하는 가장 간단한 수법은 응용프로그람의 .pro 파일에 다음행을 추가하 
는것이다 . 

DEFINES += QT_NO_CAST_ASCII 

이것은 모든 문자렬상수가 번역되여야 하는가 아닌가에 따라 tr() 나 QString :: fromAsciiO 안 
에 넣을것을 요구한다 . 적당히 넣어지지 않은 문자렬들은 콤파일시오유를 생성하므로 빠뜨린 
tr() 혹은 QString::fromAsciiO 호출을 강제로 포함하게 한다 . 

일단 사용자에게 표시하는 모든 문자렬을 tr() 호출안에 넣은 다음 번역이 가능하도록 하기 
위하여 해야 할 유일한 일은 번역파일을 적재하는것이다 . 일반적으로 응용프로그람의 main() 
함수에서 이것을 수행한다 . 례를 들면 여기에 사용자의 지역에 따라 번역파일을 적재하는 코 
드가 있다 . 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

QTranslator appTranslator; 

appTranslator.load(QString( n app_ M ) + QTextCodec: :locale(), qApp->applicationDirPath()); 

app.installTranslator(&appTranslator); 


return app.exec(); 

} 

QTextCodecxlocaleO 함수는 사용자의 지역을 지정하는 문자렬을 돌려준다 . 지역은 정확하 
거나 그렇지 않을수 있다 . 례를 들면 fr 는 프랑스어지역을 지정하고 fr_CA 는 프랑스어 카나다 
지 역을 지정하고 fr_CA.IS08859-15 는 ISO 8859-15 부호화 (’€’ ， V ’를 유지하는 부호화)를 가 
지 는 프랑스어 카나다지역 을 지 정한다 . 

지역이 fr_CA.IS08859-15 라고 가정하면 load() 는 우선 파일 app_fr_CA.IS08859-15.qm 을 적 
재하려고 시도한다 . 이 파일이 존재하지 않으면 load() 는 다음으로 app_fr_CA.qm, 그다음 
app_fr.qm, 끝으로 포기하기전에 app.qm 를 적재하려고 한다 . 보통 표준프랑스어번 역을 포함하 
는 app_fr.qm 만 제공하지만 프랑스어로 말하는 카나다용의 다른 파일을 요구한다면 
app_fr_CA.qm 도 제공할수 있으며 그것은 fr_CA 지 역들에 사용할수 있다 . 

loadO 의 둘째인수는 loadO 가 번역파일을 찾으러고 하는 등록부이다 . 이 경우에는 번역파 
일들이 실행가능파일이 있는 등록부에 배치된다고 가정한다 . 

Qt 서고자체는 번역할 필요가 있는 일부 문자렬들을 포함한다 . Trolltech 는 Qt 의 translations 
등록부에 프랑스어와 도이월란드어번역을 제공한다 . (일부 다른 언어들도 물론 제공되지만 이 



것은 Qt 사용자들이 설정하며 공식적으로 유지되지 않는다 .：) Qt 서고의 번역파일도 적재되여야 
한다 . 


QTranslator qtTranslator;qtTranslator.load(QString("qt_") + QTextCodec::locale(), 
qApp->applicationDirPath()); 
app.installTranslator(&qtTranslator); 

QTranslator 객체는 한번에 오직 하나의 번역 파일만 보유할수 있으므로 Qt 번역 마다 제각기 
QTranslator 를 사용한다 . 번 역기당 한개 파일을 주면 필요한만큼 번역기를 많이 설치할수 있으 
므로 문제시되지 않는다 . QApplication 은 번역을 탐색할 때 그것들을 모두 사용한다 . 

아랍어 와 헤 브라이어 와 갈은 일부 언 어 들은 왼쪽에서 오른쪽으로가 아니 라 오른쪽에서 
왼쪽으로 쓴다 . 그러한 언어들에서 응용프로그람의 전체 배치는 역전되 여 야 하며 이것은 
QApplication::setReverseLayout ( 仕 ue) 을 호출하여 수행한다 . Qt 서고의 번 역파일들은 언어가 왼쪽 
에서 오른쪽으로 쓰는가 오른쪽에서 왼쪽으로 쓰는가를 Qt 에 알리는 "LTR" 라는 특수한 표식 
기 (marker) 를 포함하므로 보통 그에 대하여 걱정하지 않아도 된다 . 

실행파일에 매몰된 번역파일들을 가지는 응용프로그람들을 공급한다면 사용자들에게 더 
욱 편리하다 . 이것은 제품의 부분품으로 배포되는 파일수를 줄일뿐아니라 우연히 번역파일들 
을 잃어버리거나 삭제해버 릴 위험성을 피하게 한다 . Qt 는 qembed 도구 (Qt 의 tools 등록부에 있 
다.：)를 제공하는데 이 도구는 .qm 파일들을 QTranslator :: loadO 에 넘길수 있는 C++ 배렬로 변환한 
다 . 

이제는 다른 언어들에로의 번역을 사용하여 응용프로그람이 조작할수 있게 하는데 필요 
한 모든것 에 대하여 설명하였다 . 그러 나 문서체계의 언어와 방향은 나라와 문화에 따라 달라 
지는 유일한 것이 아니다 . 국제화된 프로그람은 또한 지역의 날자와 시간형식，화폐형식 , 수 
자형식과 문자렬대조순서도 고려해야 한다 . Qt 3.2 는 이것들을 호출하는 고유한 함수들을 제공 
하지 않지만 표준 C++ 의 setlocale() 과 localeconv() 함수를 사용하여 프로그람의 현재지역을 문의 
할수 있다 . 

일부 Qt 클라스들과 함수들은 지역에 따르는 동작을 받아들인다 . 

• QSfring::localeAwareCompare() 은 지역에 의존하는 방법으로 2 개 문자렬을 비교한다 . 

이것은 QlconView 와 QListView 와 같은 클라스들에서 항목들을 정렬하는데 사용한다 . 

• QDate, QTime, QDateTime 이 제 공하는 toString() 함수는 Qt::LocalDate 를 인수로 하여 호출될 
때 지역형식의 문자렬을 돌려준다 . 

- 기 정 으로 QDateEdit, QTimeEdit, QDateTimeEdit 는 날자들을 지 역 형 식 으로 표시 한다 . 

끝으로 번역된 응용프로그람은 원래의 그림기호가 아니라 상황에 따라 다른 그림기호들 
을 사용할것을 요구한다 . 례를 들면 웨브열람기의 Back 와 Forward 단추상에서 왼쪽과 오른쪽화 
살표는 오른쪽에서 왼쪽으로 쓰는 언어를 취급할 때 교체되여야 한다 . 이것을 다음과 같이 
수행할수 있다 . 

if (QApplication: : reverseLayout()) { 




backAct -> setIconSet ( forwardIcon ); 
forwardAct -> setIconSet ( backIcon ); 

} else { 

backAct->setIconS et ( backlcon ); 
forwardAct -> setIconSet ( forwardIcon ); 

} 

자모문자를 포함하는 그림기호들은 거의 모든 경우에 번역되 여 야 한다. 례를 들면 문서처 
리기의 도구띠 단추에서 Italic 선택과 련관된 문자 T 는 에스빠냐어 에서 ' C ' { Cursivo ) S ., 단마르크 
어, 네테를란드어，도이월란드어, 노르웨이어, 스웨리예어에서 X ’여: wraV ) 로 교체되여야 한다. 
여기에 그것을 수행하는 빠른 수법이 있다. 
if ( tr (" ltalic ")[0] _ VJ { 

italicAct -> setIconSet ( iconC ); 

} else if ( tr (，， Italic ，，)[0] ==， K ，) { 
italicAct -> setIconSet ( iconK ); 

} else { 

italicAct -> setIconSet ( iconI ); 

} 

제 3 절. 동적언어절환 

대부분의 응용프로그람들에서는 mainO 에서 사용자의 언어를 람지하여 적당한 . qm 파일들 
을 적재하면 완전히 충족된다. 그러나 사용자들이 언어를 동적으로 절환할 필요가 있는 경우 
들이 있다. 여러 사람들이 번갈아 계속 사용하는 응용프로그람은 재기동하지 않고 언어를 바 
꿀것을 요구한다. 례를 들면 호출쎈터조종원, 동시통역원들, 그리고 콤퓨터화된 현금기록조종 
원들이 사용하는 응용프로그람들은 흔히 이러한 능력을 요구한다. 

동적으로 언어를 절환할수 있는 응용프로그람을 만들려면 기동시에 하나의 번역을 적재 
하는 경우보다 좀 더 작업을 해야 하지만 어렵지 않다. 여기에 그 수행방법이 있다. 

• 사용자가 언어를 절환할수 있는 수단들을 제공한다. 

• 매개 창문부품이나 대화칸에서 번역할수 있는 문자별들을 모두 개별적인 함수에 설정하 
고(흔히 retranslateStrings () 를 호출하여) 언어가 달라질 때 이 함수를 호출한다. 

Call Center 응용프로그람의 원천코드에서 관련한 부분을 고찰하자. 응용프로그람은 

Language 차림 표를 제 공하여 사용자가 언 어 를 실 행 시 에 설정 하게 한다. 기 정 언 어 는 영 어 이 다. 



I Language 
네 i 
2 Deutsch 
I": 3 English 
4 Frangais 
jinii 5 
6 日本語 

그림 15-1. Call Center 응용프로그람의 Language 차림 표 
응용프로그람이 기동할 때 사용자가 사용할 언어를 모르므로 mainG 함수에서 번역을 적재 
할 필요는 없다 . 그대신에 필요할 때 번역을 동적으로 적재해야 하므로 번역을 처리하는 코 
드는 모두 기본창문과 대화칸클라스들에 넣어야 한다 . 

Call Center 응용프로그람의 QMainWindow 파생 클라스를 고찰하자 . 

MainWindow: :MainWindow(QWidget ^parent, const char *name) : QMainWindow(parent, name) 

{ 

journal View = new Journal Vie w(this); 
setCentralWidget(j oumalView); 

qmPath = qApp->applicationDirPath() + ’’/translations”; 

appTranslator = new QTranslator(this); 

qtTranslator = new QTranslator(this); 

qApp->installTranslator(appTranslator); 

qApp->installTranslator(qtTranslator); 

createActions(); 

createMenus(); 

retranslate Strings(); 

} 

구성 자에 서 는 중심 창문부품을 QListView 의 파생 클라스 JoumalView 로 설 정 한다 . 그다음 번 
역과 관련한 여러개의 비공개성원변수들을 설정한다 . 즉 

•qmPath 변수는 응용프로그람의 번역파일들을 포함하는 등록부의 경로를 지정하는 QString 
이다 . 

- appTranslator 변수는 현재 응용프로그람번역을 보관하는데 사용된 QTranslator 객체의 지적 
자이다 . 

• qtTranslator 변수는 (가의 번역을 보관하는데 사용되는 QTranslator 객체의 지적자이다 . 

끝으로 createActionsO 와 createMenusO 비공개함수들을 호출하여 차림표체계를 창조하고 비 
공개 함수 re 仕 anslateS 仕 ings() 를 호출하여 사용자에 게 표시 하는 문자렬 들을 처 음으로 설 정 한다 . 
void MainWindow : :createActions() 

{ 
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new Act = new QAction(this); 

connect(newAct, SIGNAL(activated()), this, SLOT(newFile())); 


aboutQtAct = new QAction(this); 

connect(aboutQtAct, SIGNAL(activated()), qApp, SLOT(aboutQt())); 

} 

createActionsQ 함수는 보통처럼 QAction 객체들을 창조하지만 본문이나 지름건들을 설정하 
지 않는다 . 이 것들은 retranslateStrings() 에서 수행 한다 . 
void MainWindow: : createMenus() 

{ 

fileMenu = new QPopupMenu(this); 
newAct->addTo(fileMenu); 
openAct->addTo(fileMenu); 
saveAct->addTo(fileMenu); 
exitAct->addTo(fileMenu); 

createLanguageMenu(); 

} 

createMenusQ 함수는 차림표들을 창조하지만 차림표띠에 삽입하지 않는다 . 이것도 역시 
retranslateStrings() 에서 수행 한다 . 

함수의 끝에서는 createLanguageMenuO 를 호출하여 Language 차림표를 유지된 언어들의 목 
톡으로 채운다 . 그 원천코드를 고찰한다 . 우선 rctmnslateStringsO 를 고찰한다 . 
void MainWindow: : retranslateStrings() 

{ 

setCaption(tr( M Call Center")); 
newAct->setMenuText(tr( n &New "))； 
newAct->setAccel(tr( M Ctrl+N M )); 
newAct->setStatusTip(tr("Create a new journal’’)); 

aboutQtAct->setMenuText(tr("About &Qt")); 
aboutQtAct->setStatusTip(tr("Show the Qt library's About box’’)); 
menuBar()->clear(); 

menuBar()->insertItem(tr( n &File M ), fileMenu); 
menuBarO-^nsertltem^C'&Edit"), editMenu); 
menuBar()->insertItem(tr( n &Reports n ), reportsMenu); 



menuBar()->insertItem(tr( M &Language M ), languageMenu); 
menuBar()->insertItem(tr( n &Help n ), helpMenu); 

} 

retranslateStringsO 함수는 MainWindow 클라스용의 모든 tr () 호출이 발생하는 곳이다 . 이 함수 
는 MainWindow 구성자의 끝에서 호출되고 또한 사용자가 Language 차림표에 의 해 응용프로그 
탐의 언어를 변경할 때마다 호출된다 . 

매개 QAction 의 차림표본문 , 지름건，상태암시를 설정한다 . 또한 차림표들을 번역된 이름 
으로 차림 표띠 에 삽입 한다 . (clear () 호출은 rctmnslateStringsO 를 한번 이 상 호출할 때 필요하다 .) 

createMenus () 함수는 처음에 호출된 createLanguageMenu () 를 참고하여 Language 차림표에 언 
어목록을 채운다 . 

void MainWindow :: createLanguageMenu() 

{ 

QDir dir(qmPath); 

QStringList fileNames = dir.entryList("callcenter_*.qm’’); 
for (int i = 0;i < (int)fileNames.size();++i) { 

QTranslator translator; 

translator.load(fileNames[i], qmPath); 

QTranslatorMessage message = translator.findMessage( M MainWindow n , ’’English’’); 

QString language = message.translation(); 

int id = languageMenu->insertItem( tr("&%l %2") 

.arg(i + l).arg(language), this, SLOT(switchToLanguage(int))); 
languageMenu->setItemParameter(id, i); 
if (language = "English") 

languageMenu->setItemChecked(id, true); 

QString locale = fileNames[i]; 
locale = locale.mid(locale.find(’_’) + 1); 
locale.truncate(locale.find(V)); 
locales.pushback(locale); 

} 

} 

응용프로그람이 유지 하는 언 어 들을 코드작성 하지 않고 응용프로그람의 translations 등록부 
에 배치된 매개 .qm 파일용으로 차림표항목을 하나씩 창조한다 . 단순히 영어용의 .qm 파일이 
있다고 가정한다 . 사용자가 영 어를 선택할 때 QTranslator 객체들에 대하여 clear 。 를 선택하는 
방법이 있다 . 

한가지 특별한 난관은 매개 .qm 파일이 제공하는 언어용으로 좋은 이름을 제시하는것이 



다 . .qm 파일의 이름에 기초하여 English 를 en 으로 혹은 Deutsch 를 (노로 표시 하면 미숙해보이며 
일부 사용자들은 혼돈한다 . createLanguageMenu () 에서 사용한 방법은 MainWindow 문맥에서 문 
자렬 "English ” 의 번 역을 검사하는것 이 다 . 그 문자렬은 도이월란드어번역 에서 "Deutsch” 로 , 프 
랑스어번역 에서 ’’Franfais" 로，일본어번 역 에서 " 日本語”로 번역되 여 야 한다 . 

QPopupMenu: : insertltem()-i- 리용하여 차림 표항목들을 창조한다 . 이 것 들은 모두 기 본창문의 
switchToLanguage(int) 처 리 부에 련결 되 는데 다음에 고찰한다 . switchToLanguage(int) 처 리 부의 파라 
메터는 setItemParameter () 에 의해 설정한 값이다 . 이것은 3 장에서 표계산프로그람의 최근에 연 
파일목록을 실현할 때 수행한것과 아주 비숫하다 . 

끝으로 switchToLanguage () 을 실현하는데 사용하는 locales 라고 부르는 QS 仕 ingList 에 지역을 
추가한다 . 

void MainWindow: : switchToLanguage(int param) 

{ 

appTranslator->load("callcenter_" + locales[param], qmPath); 

qtTranslator- 〉 load(’’qt_" + locales [param], qmPath); 

for (int i = 0; i < (int)languageMenu->count(); ++i) 

languageMenu->setItemChecked(languageMenu->idAt(i), i == param); 

retranslate Strings(); 

} 

switchToLanguageO 처리부는 사용자가 Language 차림표로부터 언어를 선택할 때 호출된다 . 
응용프로그람과 (가용의 번역 파일을 적재하는것으로 시작한다 . 그다음 Language 차림 표항목앞의 
검사표식들을 갱신하여 사용중에 있는 언어를 표식하고 retranslateStrings () 를 호출하여 기본창 
문의 문자렬들을 모두 재번역한다 . 

Microsoft Windows 에서 Language 차림표를 제공하는 다른 수법은 환경의 지역에서 변화를 
탐지할 때 어에 의해 발생 된 사건 형 인 LocaleChange 사건 에 응답하는것 이 다 . 사건 형 은 어에 유 
지된 모든 가동환경들에서 존재하지만 Windows 에서는 사용자가 체계의 지 역설정 (Control Panel 
의 Regional and Language Options ) 을 변경 할 때 실제로 생성 된다 . LocaleChange 사건들을 조종하 
기 위하여 QObject::event () 를 다음과 같이 재정의한다 . 
bool MainWindow :: event(QEvent * event) 

{ 

if (event->type() == QEvent: : LocaleChange) { 

appTranslator->load(QString( n callcenter_ n ) + QTextCodec: :locale(), qmPath); 
qtTranslator->load(QString(’’qt_’’) + QTextCodec::locale(), qmPath); 
retranslate Strings(); 

} 

return QMainWindow::event(event); 




응용프로그람이 실행중에 있을 때 사용자가 지역을 절환하면 새 지역용의 정확한 번역파 
일들을 적재하고 retranslateStringsO 를 호출하여 사용자대면부를 갱신한다 . 

모든 경우에 기초클라스중 하나가 LocaleChange 사건들과 관련될수도 있으므로 기초클라스 
의 event 。 함수에 대하여 사건을 넘긴다 . 

이 것 으로 MainWindow 코드의 고찰을 끝낸 다 . 그러 면 응용프로그람의 창문부품클라스들중 
하나인 JoumalView 클라스의 코드를 고찰하여 동적번 역을 유지하려 면 어떤 변경 이 필요한가를 
고찰해 보자 . 

JoumalView: : JoumalView(QWidget ^parent, const char *name) : QListView(parent, name) 

{ 


retranslate Strings(); 

} 

JoumalView 클라스는 QListView 의 파생클라스이다 . 구성자의 끝에서 비공개함수 
retranslateStringsO 를 호출하여 창문부품의 문자렬들을 설정한다 . 이 것은 MainWindow 에서 수행 
한것과 비숫하다 . 

bool JoumalView: : event(QEvent *event) 

{ 

if (event->type() == QEvent :: LanguageChange) 
retranslateStrings(); 
return QListView: : event(event); 

} 

event () 함수를 재정의하여 LanguageChange 사건들에 대하여 retranslateStrings () 를 호출한다 . 

(가는 QApplication 에 현재 설치된 QTranslator 의 내용이 변할 때 LanguageChange 사건을 생 
성한다 . Call Center 응용프로그람에서 이것은 MainWindow::switchToLanguage () 나 MainWindow: : 
event () 로부터 appTranslator 혹은 qtTranslator 에 대하여 load () 를 호출할 때 발생한다 . 

LanguageChange 사건들은 LocaleChange 사건들과 같지 않다 . LocaleChange 사건은 응용프로그 
람에 ’’Maybe you should load a new translation . ’’라고 알린다 . 대조적으로 LanguageChange 사건 
은 응용프로그람의 창문부품들에 "Maybe you should retranslate all your strings .” 라고 알린다 . 

MainWindow 를 실현했을 때 LanguageChange 에 응답할 필요가 없었다 . 그대신에 QTranslato 
r 에 대하여 load () 를 호출했을 때마다 단순히 retranslateStringsO 를 호출하였다 . 

void JoumalView: : retranslateStrings() 

{ 

for (int i = columns() -1; i >= 0; ~i) 
removeColumn(i); 




addColumn (仕 (’’Time，，)); 
addColuimi (仕 ("Priority")); 
addColumn (仕 ("Phone Number"))； 
addColuimi (仕 (" Subject")); 

} 

rettanslateStrings() 함수는 새로 번역된 본문을 가지고 QListView 의 렬제목들을 다시 창조한 
다. 모든 렬제목들을 삭제하고 새로운 렬제목들을 추가하고 이것을 수행한다. 이 조작은 오직 
QListView 제목에 만 영향을 주며 QListView 에 보관한 자료에는 영향을 주지 않는다. 

이것으로 손으로 쓴 창문부품의 번역관련코드의 설명을 끝낸다. Qt Designer 로 개발한 창 
문부품과 대화칸들에서 uic 도구는 LanguageChange 사건들에 응답하여 자동적으로 호출되는 
retranslateStrings() 함수와 비슷한 함수를 자동적으로 생성한다. 우리 가 해 야 할 일은 사용자가 
언어를 절환할 때 번역파일을 적재하는것이다. 

제4절. 음용프로그람의 번역 

tr() 호출을 포함하는 Qt 응용프로그람의 번역은 3단계의 과정으로 되 여있다. 

① lupdate 를 실행하여 사용자에게 표시하는 문자렬들을 응용프로그람의 원천코드에서 
엄는다. 

② Qt Linguist 에 의 하여 응용프로그람을 번 역한다. 

③ lrelease 을 실행하여 응용프로그람이 QTranslator 를 사용하여 적재하는 2진 .qm 파일을 생 
성 한다. 

걸음 ①과 ③은 응용프로그람개발자들이 수행한다. 걸음 ②는 번역기 가 처 리한다. 이 주 
기는 응용프로그람의 개발과 수명기간 필요할 때마다 반복될수 있다. 

실례로 3장의 표계산프로그람을 번역하는 방법을 보기로 한다. 응용프로그람은 이미 사용 
자에게 표시하는 문자렬주위 에 tr() 호출을 포함한다. 

우선 응용프로그람의 .pro 파일을 수정하여 유지하려는 언어들을 지정해야 한다. 례를 들 
면 영 어와 함께 도이월 란드어 와 프랑스어 를 유지 하려 고 한다면 다음의 TRANSLATIONS 항목 
을 spreadsheet.pro 에 추가해 야 한다. 

TRANSLATIONS = spreadsheet de.ts \ spreadsheet_fr.ts 

여기서는 2개의 번 역파일 즉 도이월란드어파일과 프랑스어파일을 지 정한다. 이 파일들은 
처음으로 lupdate 를 실행할 때 창조되고 후에 lupdate 를 실행할 때마다 갱신된다. 

보통 이 파일들은 .ts 확장자를 가전다. 이것들은 간단한 XML 형식으로 되 여있고 
QTranslator 에 의해 해석된 2진 .qm 파일들처럼 조밀하지 않다. 사람이 읽을수 있는 .ts 파일을 를 
퓨터 에 효과적 인 .qm 파일들로 변환하는것 은 lrelease 의 일감이다. 자세 히 말하면 효는 번 역 원 
천파일을 의 미 하고 .qm 은 Qt 통보문파일을 의 미한다. 

우리가 표계산프로그람의 원천코드를 포함한 등록부안에 있다고 가정하면 spreadsheetpro 
에 대하여 지령행에서 lupdate 를 다음과 같이 실행할수 있다. 




lupdate -verbose spreadsheet.pro 

-verbose 인수는 선택인수이다. 이것은 lupdate 에 보통보다 반결합을 더 제공한다는것을 알 
린다. 여기에 기대한 출력이 있다. 

Updating ' spreadsheet _ de . ts '... 

0 known , 101 new and 0 obsoleted messages 
Updating ' spreadsheet _ fr . ts ’... 

0 known , 101 new and 0 obsoleted messages 

응용프로그람원천코드의 tr () 호출안에서 나타나는 모든 문자렬은 빈 번역을 가지는 .ts 파일 
들에 보관된다. 응용프로그람의 . ui 파일들에 나타나는 문자별들도 포함된다. 

lupdate 도구는 기정으로 배인수들이 Latin -1 문자렬이라고 가정한다. 그렇지 않으면 CODEC 
항목을 .pro 파일에 추가해야 한다. 례를 들면 
CODEC = EUC-JP 

이것은 응용프로그람의 mainO 함수로부터 QTextCodec :: setCodecForTr (} 호출과 함께 수행되 
여야 한다. 

그다음 Qt 응용프로그람들을 번역하는 GUI 도구인 Qt Linguist 를 리용하여 spreadsheet _ de.ts 
와 spreadsheet _ fr.ts 파일에 번역을 추가해야 한다. 

Qt Linguist 를 기동하려면 Windows 에서는 Start 차림표에서 Qt 3.2. x|Qt Linguist 를 찰칵하고 
Unix 에서는 지령행에서 linguist 라고 입 력하며 Mac OS X Finder 에서는 linguist 를 두번 찰칵한 
다. . ts 파일에 대한 번역추가를 시작하려면 File|Open 를 찰칵하고 파일을 선택 한다. 

Qt Linguist 기본창문의 왼쪽에 번역중에 있는 응용프로그람의 문맥목록들이 표시된다. 표 
계 산프로그람에 서 문맥 들로서 는 FindDialog , GoToCellDialog , MainWindow , SortDialog , Spreadsheet 
가 있다. 오른쪽웃구역은 현재 문맥용의 원천본문목록이다. 매개 원천본문은 번역과 £> o « e 기발 
과 함께 표시된다. 오른쪽 중간구역은 현재 원천항목의 번역을 입력할수 있는 곳이다. 오른쪽 
아래 구역 은 Qt Linguist 가 자동적 으로 제 공하는 제 안목록이 다. 

번역된 .ts 파일을 일단 엄으면 그것을 2진 .qm 파일로 변환하여 QTranslator 가 리 해 할수 있게 
해야 한다. 그러자면 Qt Linguist 안에서 File|Release 를 찰칵한다. 일반적으로 일부 문자렬만 번 
역하는것으로 시작하며 .qm 파일을 가지고 응용프로그람을 실행하여 제대로 작업하는가 확인 
한다. 




그림 15-2. Qt Linguist 의 작용 

모든 .ts 파일들에 대 하여 .qm 파일들을 다시 생 성 하려 고 한다면 lrelease 지 령 행 도구를 다음 
과 같이 사용한다. 

lrelease -verbose spreadsheet.pro 

19개 문자렬을 프랑스어로 번역하고 그중 17개에 Done 기발을 찰칵하였다고 가정하면 
lrelease 는 다음의 출력 을 생 성한다. 

Updating ' spreadsheet _ de . qm '... 

0 finished , 0 unfinished and 101 untranslated messages 

Updating ' spreadsheet _ fr . qm '... 

17 finished , 2 unfinished and 82 un 仕 anslated messages 

번역하지 않은 문자별들은 응용프로그람을 실행할 때 원래언어로 표시된다. Done 기발은 
lrelease 가 사용하지 않으며 번역기들이 어느 번역을 끝내고 어느 번역을 다시 방문해야 하는 
가를 식별하는데 쓰인다. 

응용프로그람의 원천코드를 수정할 때 번 역 파일들이 갱신될수 있다. 해결책 은 lupdate 를 
다시 실행하고 새 문자렬들의 번역을 제공하고 .qm 파일들을 다시 생성하는것이다. 일부 개발 
림 들은 lupdate 를 자주 실행하기 좋아하며 다른 림 들은 최종제품을 출하하기 직전까지 기다리 
기를 좋아한다. 

lupdate 와 Qt Linguist 도구는 아주 고급한 도구이다. 더는 사용하지 않는 번역은 후에 출하 
할 때 요구되는 경우에만 .ts 파일들에 보관한다. .ts 파일들을 갱신할 때 lupdate 는 지능결합알고 







제 16 장. 직결방조의 제공 


대부분의 응용프로그람들은 사용자에게 직결방조를 제공한다. 어떤 방조는 도구암시와 상 
태 암시， What’s This ? 방조와 같이 간단하다. (가는 이 것들을 모두 제공한다. 다른 방조는 훨씬 범 
위가 넓고 많은 본문폐지를 요구한다. 이러한 종류의 방조에서는 QTextBrowser 를 단순한 직결 
방조열 람기 로 사용하거 나 자기 의 응용프로그람으로부터 Qt Assistant 혹은 다른 HTML 열 람기 를 
펼칠수 있다. 


제1절. 도구암시와 상태암시， What's This ? 방조 

도구암시는 일정한 시간동안 창문부품우에서 마우스가 머무를 때 나타나는 자그마한 본 
문부분이다. 도구암시는 황색배경에 흑색본문으로 표시된다. 그 주되는 용도는 도구띠단추들 
에 본문설 명 을 제 공하는것 이 다. 

QToolTip :: addO 를 사용하여 임의의 창문부품들에 도구암시를 추가할수 있다. 례를 들면 
QToolTip :: add ( findButton , tr("Find next "))； 

QAction 에 대 응하는 도구띠단추의 도구암시 를 설 정 하려 면 간단히 그 작용에 대 하여 
setToolTip () 를 호출해야 한다. 례를 들면 

newAct = new QAction ( tr ("& New "), 仕 (" ari + N "), this ); 
newAct -> setToolTip (仕 ("New file "))； 

도구암시를 명시적으로 설정하지 않으면 QAction 은 작용본문과 지름건(례를 들면 "New 
( Orl + N )") 으로부터 자동적 으로 생 성한다. 

상태암시 도 역 시 짧은 설명 본문으로서 보통 도구암시 보다 좀 길다. 마우스가 도구띠단추 
나 차림 표선 택 우에 머 무를 때 상태 암시 가 상태 띠 에 나타난다. setStatusTipO 를 호출하여 작용에 
상태암시 를 추가한다. 

newAct -> setStatusTip (仕 ("Create a new file "))； 

상태암시 가 없을 때 QAction 은 그대신 에 도구암시 본문을 사용한다. 

QAction 을 사용하지 않으면 QToolTipGroup 객체와 상태암시를 QToolTip :: add () 의 셋째와 넷 
째 인수로서 넘겨야 한다. 

QToolTip :: add ( findButton , 仕 ("Find next "), toolTipGroup , 

仕 ("Find the next occurrence of the search text ")); 

응용프로그람은 QToolTipGroup 의 showTip () 와 removeTip () 신호들을 상태 띠의 message () 와 
clear () 처 리 부들에 련 결 함으로써 상태 띠 에 긴 본문을 표시 할수 있 다. QToolTipGroup 객 체 는 긴 
방조본문을 표시할수 있는 도구암시들과 창문부품사이의 교제를 관리할수 있는 응답성이 있 
어야 한다. 
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그림 16-1. 도구암시 와 상태암시 를 표시 하는 응용프로그람 


H Designer ^ ^ 도구암시 와 상태 암시 는 창문부품이 나 작용의 도구암시 와 statusTip 속성 들 
하여 호출할수 있다. 

!부 상황에서는 창문부품에 대하여 도구암시나 상태암시로 줄수 있는것보다 많은 정보 
공해야 한다. 례를 들면 복잡한 대화칸에서 개별적인 방조창문을 사용자가 펼치지 않고 
당에 대 한 설명 본문을 제공해 야 한다. What’s This ? 방식 은 이 를 위 한 리 상적 인 해결책 이 다 
'1 What's This ? 방식에 있을 때 유표는 次?로 변경되고 사용자는 임의의 사용자대면부부분 
찰칵하여 방조본문을 얻을수 있다. What's This ? 방식 에 들어가기 위하여 사용자는 대화칸 
목띠 (Windows 와 KDE ) 의 ?단추를 찰칵하거나 *Sh 하 + F 1 를 누를수 있다. 

) ■조본문은 QWhatsThis :: add () 를 호출하여 설정할수 있다. 여기 에 실례가 있다. 

QWhatsThis : : add ( sourceLineEdit , 

仕 ("<img src =\" icon . png \">" 

"& nbsp;The meaning of the Source field depends on the Type field :" 

"< ul >" 

"< li >< b > Books </ b > have a Publisher </ li >" 

"< li >< b > Articles </ b > have a Journal name with volume and issue numbeK / li >" 
"< li >< b > Thesis </ b > have an Institution name and a department name </ li >" 
"</ ul >")); 

f 른 많은 Qt 창문부품들처럼 HTML 형식꼬리표들을 사용하여 도구암시의 본문을 형식화 
있다. 실례에서는 화상(응용프로그람의 .pro 파일에서 IMAGE 항목에 렬거된다.)，게시목록， 
11 의 본문을 포함한다. Qt 가 유지하는 꼬리표들은 QStyleSheet 문서 에 지정된다. 








그림 16-2. What’s This ? 방조본문을 표시 하는 대 화칸 


또한 작용에 대하여 What’s This ? 본문을 설정 할수 있다. 
openAct -> setWhatsThis ( tr("<img src = open . png >& nbsp ;" 

’’Click this option to open an existing file .")); 

본문은 What’s This ? 방식 에 있을 때 사용자가 차림 표항목이 나 도구띠 단추를 찰칵하거 나 지 
름건 을 누를 때 표시 된다. Qt Designer 에 서 창문부품이 나 작용의 What’s This ? 본문은 whatsThis 속 
성을 통하여 사용할수 있다. 

응용프로그람기 본창문의 사용자대 면 부부분품들은 What's This ? 본문을 제 공할 때 What's 
This ? 도구띠단추는 물론 Help 차림 표에 What’s This ? 선 택 을 제 공하는것 이 관례 로 되 여 있 다. 이 것 
은 What's This ? 작용을 창조하고 그 activated () 신호를 실행시에 What's This ? 방식에 들어가는 
QMainWindow 의 whatsThisQ 처리부에 련결하여 수행한다. 

제2절. 단순한 방조엔진 QTextBrowser 의 사용 

크고 복잡한 웅용프로그람들은 도구암시，상태암시 , What's This ? 방조가 제 공하는것 보다 더 
많은 직결방조를 요구한다. 간단한 해결책은 방조열람기를 제공하는것이다. 일반적으로 방조 
열람기를 제공하는 응용프로그람들은 기본창문의 Help 차림표에 Help 항목을 모든 대화칸에 
Help 단추를 가지고있다. 

이 절에서는 그림 16-3 에 보여주는 간단한 방조열람기를 표시하고 응용프로그람에서 그 
사용방법 을 설 명한다. 창문은 QTextBrowser 를 사용하여 HTML 기 초문법 으로 표식 되 는 방조폐 
지들을 실현한다. QTextBrowser 는 수많은 단순한 HTML 꼬리표들을 처리할수 있으므로 이러한 
목적에 리상적이다. 
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머리부파일부터 시작하자. 

#include < qwidget . h > 
class QPushButton;class QTextBrowser ; 
class HelpBrowser : public QWidget 
{ 

Q_OBJECT 

public : 

HelpBrowser(const QString & path , const QString & page , QWidget ^parent = 0, 
const char *name = 0); 
static void showPage(const QString & page ); 
private slots : 

void updateCaption (); 
private : 

QTextBrowser * textBrowser ; 

QPushButton * homeButton ; 

QPushButton * backButton ; 

QPushButton * closeButton ; 

}； 

HelpBrowser 는 응용프로그람의 어디서나 호출할수 있는 정적함수를 제공한다. 이 함수는 
HelpBrowser 창문을 창조하고 주어진 폐지를 표시한다. 
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여기에 실현의 앞부분이 있다 . 

#include <qapplication.h> 

#include <qlayout.h> 

#include <qpushbutton.h> 

#include <qtextbrowser.h> 

#include "helpbrowser.h" 

HelpBrowser: : HelpBrowser(const QString &path, const QString &page, QWidget *parent, 
const char *name) : QWidget(parent, name, WGroupLeader | WDestructiveClose) 

{ 

textBrowser = new QTextBrowser(this); 
homeButton = new QPushButton(tr("&Home n ), this); 
backButton = new QPushButton(tr( n &Back"), this); 
closeButton = new QPushButton(tr("&Close"), this); 
closeButton->setAccel(tr( M Esc M )); 

QVBoxLayout *mainLayout = new QVBoxLayout(this); 

QHBoxLayout *buttonLayout = new QHBoxLayout(mainLayout); 

buttonLayout->addWidget(homeButton); 

buttonLayout->addWidget(backButton); 

buttonLayout->addStretch( 1); 

buttonLayout->addWidget(closeButton); 

mainLayout->addWidget(textBrowser); 

connect(homeButton, SIGNAL(clicked()), textBrowser, SLOT(home())); 
connect(backButton, SIGNAL(clicked()), textBrowser, SLOT(backward())); 
connect(closeButton, SIGNAL(clicked()), this, SLOT(close())); 
connect(textBrowser, SIGNAL(sourceChanged(const QString &)), this, 

SLOT (updateCaption())); 

textBrowser->mimeSourceFactory()->addFilePath(path); 

textBrowser->setSource(page); 

} 

배치에는 단순히 QTextBrowser 의 제일 우의 한행에 놓인 단추들이 포함된다 . path 파라메터 
는 응용프로그람의 문서 를 포함하는 파일체계안의 경 로이 다 . page 파라메터 는 문서파일의 이 름 
인데 선택적인 HTML 닻 (anchor) 을 가지고있다 . 

기 본창문과 함께 이 행 금지 대 화칸으로부터 HelpBrowser 창문들을 펼 치 려 고 하므로 
WGroupLeader 기발을 사용한다 . 보통 이 행 금지 대화칸은 사용자가 응용프로그람의 다른 창문과 
교제하는것 을 방지한다 . 그러 나 방조요구후에 사용자는 명 백히 이 행금지대화칸와 방조열 람기 






모두와 교제할수 있게 되여야 한다 . WGroupLeader 기발의 사용은 이 교제를 가능하게 한다 . 
void HelpBrowser: : updateCaption() 

{ 

setCaption ( 仕 ("Help: %1") ,arg(textBrowser->documentTitle())); 

} 

원천폐지가 달라질 때마다 updateCaption () 처리부가 실행된다 . documentTitle () 함수는 폐지의 
<title > 꼬리표에 지정한 본문을 돌려준다 . 

void HelpBrowser::showPage(const QString &page) 

{ 

QString path = qApp->applicationDirPath() + "/doc"; 

HelpBrowser *browser = new HelpBrowser(path, page); 

browser->resize(500, 400); 

browser->show(); 

} 

showPage () 정 적 함수에 서 는 HelpBrowser 창문을 창조하고 그것 을 표시 한다 . 구성 자에 서 
WDestructiveClose 기발을 설정하였으므로 창문은 사용자가 닫을 때 자동적으로 해체된다 . 

이 실례에서는 응용프로그람의 실행파일을 포함하는 등록부의 doc 보조등록부에 문서가 
배치 된다고 가정 한다 . showPage () 함수에 넘 긴 모든 폐지 는 이 doc 보조등록부로부터 얻는다 . 

이제는 응용프로그람으로부터 방조열람기 를 펼칠 준비가 되 였다 . 응용프로그람의 기본창 
문에서는 /fe 必작용을 창조하고 그것을 다음과 갈은 helpO 처 리부에 련결한다 . 
void MainWindow :: help() 

{ 

HelpBrowser: : showPage("index.html"); 

} 

이 것은 기 본방조파일 이 index.html 로부터 호출된다고 가정 한다 . 대화칸들에서 는 Help 단추 
를 다음과 갈은 help () 처 리부에 련결한다 . 
void EntryDialog :: help() 

{ 

HelpBrowser::showPage("dialogs.html#entrydialog"); 

} 

여기서는 다른 방조파일인 dialogs.html°11 있으며 QTextBrowser 를 entrydialog 닻으로 흘림한 
다 . 

방조를 펼칠수 있는 또 다른 위치는 What's This? 본문이다 . HTML <a href 꼬리표들을 
사용하여 What’s This ? 본문을 문서 에 련 결 할수 있다 . 
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그림 16-4. 련결을 가진 What’s This? 본문 

What's This? 본문으로부터 초본문련결이 동작하게 하기 위하여 방조열람기를 알고있는 
QWhatsThis 를 사용해야 한다 . 이것은 QWhatsThis 의 파생클라스를 만들고 그의 clicked() 함수를 
재정의하고 HelpBrowser::showPageO 를 호출하여 달성한다 . 여기에 클라스정의가 있다 . 
class MyWhatsThis : public QWhatsThis 
{ 

public: 

MyWhatsThis(Q Widget * widget, const QString &text); 

QString text(const QPoint &point); 
bool clicked(const QString &page); 
private: 

QString myText; 

}； 

text() 와 clicked() 함수는 QWhatsThis 로부터 재정의된다 . 

MyWhatsThis::MyWhatsThis(QWidget *widget, const QString &text) 

: QWhatsThis(widget) { myText = text;} 

구성자는 창문부품과 그 창문부품의 What’s This? 본문을 받아들인다 . 창문부품을 기초클 
라스에 넘기고 본문을 비공개변수에 보관한다 . 

QString MyWhatsThis: : text(const QPoint &) { return myText;} 

textO 함수는 마우스유표위치가 주어진 창문부품용의 What’s This? 본문을 돌려준다 . 일부 창 
문부품들에서는 사용자가 찰칵한 위치에 따라 각이한 본문을 돌려주어야 하지만 여기서는 늘 
갈은 본문을 돌려준다 . 

bool MyWhatsThis: :clicked(const QString &page) 

{ 

if (page.isEmpty()) { 
return true; 

} else { 


360 




HelpBrowser: :showPage(page); 
return false; 

} 

} 

clickedO 함수는 사용자가 What’s This? 창문우에 서 찰칵할 때 QWhatsThis 에 의 하여 호출된 다 . 
사용자가 HTML 련결을 찰칵했을 때 QWhatsThis 는 목표폐지를 clicked() 함수에 넘긴다 . (아무것 
도 찰칵하지 않았으면 빈 문자렬을 넘 긴다 .) 방조열 람기 를 펼치 고 주어 진 폐지 를 표시한다 . 

clkkedO 의 돌림 값은 QWhatsThis 가 What's This? 본문을 숨겨 야 하는가 (true 로 지 적 한다 .) 계 
속 표시하여야 하는가를 결정하는데 사용된다 . 사용자가 련결을 찰칵할 때 What's This? 가 방 
조창문에 계속 표시되기를 바라므로 false 를 돌려준다 . 사용자가 What's This? 창문안의 어떤 곳 
을 찰칵하면 true 를 돌려 주어 What’s This? 창문을 숨긴 다 . 

여기에 MyWhatsThis 클라스를 사용하는 방법이 있다 . 
new MyWhatsThis(sourceLineEdit, 

仕 (”<img src=\"icon.png\">" 

"&nbsp;The meaning of the " 

"<a href=\"fields.html#source\">Source</a> field depends on " 

"the <a hrel=\"iields.html#type\">Type</a> field:" 

"<ul>" 

"<li><b>Books</b> have a Publisher</li>" 

"<li><b>Articles</b> have a Journal name with volume and issue number</li>" 
"<lixb>Thesis</b> have an Institution name and a department name</li>" 

"</ u l>")); 

QWhatsThis :: add() 을 호출하지 않고 창문부품과 그 련관본문을 가지는 MyWhatsThis 객체 
를 창조한다 . 그러나 이번에 사용자가 련결을 찰칵하면 방조열람기가 펼쳐진다 . 

new 를 리용하여 객체를 할당하고 변수에 값을 대 입 하지 않는다 . 이 것은 어가 모든 
QWhatsThis 객체들의 상태를 보관하고있다가 그것들이 더는 요구되지 않을 때 삭제하면 여기 
서 문제로 되지 않는다 . 

제3절. 강력한 직결방조 Qt Assistant 의 사용 

Qt Assistant 는 Trolltech 가 제 공하는 재 배 포가능한 직 결 방조프로그람이 다 . 그 주요한 우점 은 
색 인화와 완전본문탐색을 유지 하고 응용프로그람들에서 여 러 개의 문서모임 들을 처 리할수 있 
는것이다 . 

Qt Assistant 를 사용하려 면 응용프로그람에 필요한 코드를 통합하여 Qt Assistant 가 문서를 
알게 하여야 한다 . 

Qt 응용프로그람과 Qt Assistant 사이의 교제는 개별적 인 서고에 배치된 QAssistantClient 에 의 
해 처리된다 . 서고를 응용프로그람과 련결하려면 다음 행을 응용프로그람의 .pro 파일에 추가 






해야 한다 . 

LIBS += -lqassistantclient 

그러면 QtAssistant 를 사용하는 새로운 HelpBrowser 클라스의 코드를 고찰하자 . 

#ifndef HELPBROWSER_H 
#define HELPBROWSER_H 
class QAssistantClient; 
class HelpBrowser 
{ 

public: 

static void showPage(const QString &page); 
private: 

static QAssistantClient * assistant; 

}； 

#endif 

여기에 새로운 helpbrowser.cpp 가 있다 . 

#include <qassistantclient.h> 

#include ''helpbrowser.h" 

QAssistantClient *HelpBrowser: : assistant = 0; 
void HelpBrowser: :showPage(const QString &page) 

{ 

if (! assistant) 

assistant = new QAssistantClient("’’); 
assistant->showPage(page); 

} 

QAssistantClient 구성자는 경로문자렬을 첫 인수로 받아들인다 . 이것은 Qt Assistant 실행파일 
을 탐색하는데 사용된다 . 빈 경 로를 넘기 면 QAssistantClient 가 PATH 환경변수안에서 실행파일 
을 찾는다 . 

QAssistantClient 는 처음에 QTextBrowser 파생 클라스의 showPage() 함수와 같이 선택적인 
HTML 닻을 가지는 폐지이름을 받아들이는 자체의 showPageO 함수를 가지고있다 . 

다음 단계 는 Qt Assistant 에 게 문서 가 있는 위 치 를 알리 는것 이 다 . 이 것 은 Qt Assistant 프로파 
일을 창조하고 문서에 대한 정보를 제공하는 .dcf 파일을 창조함으로써 수행한다 . 이것은 모두 
Qt 참고자료 ( 도구편)의 3 장에서 설명한다 . 

QTextBrowser 나 Qt Assistant 를 사용하는 다른 방법은 가동환경 에 고유한 수법으로 직 결방 
조를 제 공하는것 이 다 . Windows 응용프로그람들에서 는 Windows HTML 방조파일 들을 창조하고 
Microsoft Internet Explorer 에 의하여 그것들을 호출할수 있다 . 여의 QProcess 클라스 혹은 
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ActiveQt 틀거 리를 사용할수 있다 . Unix 와 Mac OS X 응용프로그람들에서 적 합한 수법은 HTML 
파일들을 제 공하여 웨 브열 람기 를 펼치 는것 이 다 . 



제 17 장. 다중스레드작성 

보통의 GUI 응용프로그람들은 하나의 실행스레드를 가지며 한번에 하나의 조작을 수행한 
다 . 사용자가 단일스레드 응용프로그람에서 사용자대면부로부터 시간을 소비하는 조작을 호 
출하면 그 조작이 처리되는동안 대면부는 일반적으로 동결된다 .7 장 ( 사건처리)은 이 문제에 대 
한 대책을 제공하며 다중스레드작성은 또 하나의 대책으로 된다 . 

다중스레드 Qt 응용프로그람에서 GUI 는 자기의 스레드에서 실행되며 처리는 하나이상의 
다른 스레드들에서 진행된다 . 이것은 긴장한 처리를 하는 경우에도 응용프로그람들이 제각기 
GUI 를 가지게 한다 . 다중스레드작성의 다른 하나의 리득은 다중처리소자콤퓨터들에서 서로 
다른 스레드들을 동시에 각이한 처리소자들에서 실행하여 좋은 성능을 낼수 있다는것이다 . 

이 장에서는 우선 QThread 의 파생클라스를 만드는 방법과 스레드들을 동기시키는데 
QMutex, QSemaphore, QWaitCondition 를 사용하는 방법을 보여준다 . 그다음 사건순환고리를 실 
행하는동안 비 GUI 스레드들에서 GUI 스레드와 교제하는 방법을 보여주고 어느 Qt 클라스들을 
비 GUI 스레드들에서 사용할수 있고 어느것을 사용할수 없는가 고찰한다 . 

다중스레드작성은 큰 주제로서 이것을 포괄적으로 설명하는 도서들은 많다 . 여기서는 다 
중스레드프로그람작성의 기초를 리해하고있는것을 전제로 하고 스레드작성 그 자체보다도 다 
중스레 드 Qt 응용프로그람개 발방법 을 설 명 하는데 초점 을 둔다 . 

제1절. 스레드와의 작업 

Qt 응용프로그람에서 다중스레드를 제공하는것은 간단하다 . 즉 QThread 의 파생클라스를 만 
들고 그의 run() 함수를 재 정의한다 . 그 과정 을 보여 주기 위 하여 우선 콘솔에 같은 본문을 반 
복 출력하는 아주 간단한 QThread 의 파생클라스코드를 고찰한다 . 

class Thread : public QThread 

{ 

public: 

Thread(); 

void setMessage(const QString &message); 
void run(); 
void stop(); 

private: 

QString messageStr; 
volatile bool stopped; 

}； 

Thread 클라스는 QThread 를 계승하며 run() 함수를 재정의한다 . 이 클라스는 2 개의 추가함수 
setMessage() 와 stop() 을 제공한다 . 



stopped 변수는 각이 한 스레드들로부터 호출되 고 필요할 때마다 새로 읽어 들이는것을 확인 
하려 고 하므로 volatile 로 선 언 한다 . volatile 예 약어 를 생 략하면 콤파일 러 는 변수호출을 최 적 화할 
수 있으나 부정확한 결과를 초래할수 있다 . 

Thread: :Thread() 

{ 

stopped = false; 

} 

구성 자에 서 stopped 를 false 로 설 정한다 . 
void Thread: :run() 

{ 

while (! stopped) 

cerr « messages 仕 .ascii(); 

stopped = false; 

cerr « endl; 

} 

mn() 함수가 호출되면 스레드실행이 시작된다 . stopped 변수가 false 인 경우에 함수는 콘솔에 
주어진 통보문을 출력한다 . 스레드는 조종이 mnO 함수를 벗어날 때 완료한다 . 
void Thread::stop() 

{ 

stopped = true; 

} 

stopO 함수는 stopped 변수를 true 로 설정하여 mnO 이 콘솔에 대한 본문출력을 정지하게 한 
다 . 이 함수는 임의의 스레드로부터 임의의 시간에 호출할수 있다 . 실례에서는 bool 에 대한 
대입이 원자연산이라고 가정한다 . 이것은 타당한 가정으로서 bool 이 仕에나 false 라는것을 고려 
한다 . 이 절에서 후에 QMutex 를 사용하여 변수에 대한 대입이 원자연산이라는것을 담보하는 
방법을 알게 된다 . 

QThread 는 실행중에 있는 스레드의 실행을 완료하는 terminate() 함수를 제공한다 . 
terminate() 의 사용은 권고하지 않는다 . 그것은 임의의 점에서 스레드를 정지시킬수 있고 후에 
스레드에 그자체를 삭제할 기회를 주지 않기때문이다 . 여기서 수행하는것처럼 stopped 변수와 
stopO 함수를 사용하는것이 늘 안전하다 . 


■ Threads |T|g 


[ Start A | | Start B ] {......" Quit 


그림 17-1. Threads 응용프로그람 





이제는 처음의 스레드와 함께 2 개의 스레드 A 와 B 를 사용하는 자그마한 Qt 응용프로그람 
에서 Thread 클라스를 사용하는 방법을 고찰한다 . 
class ThreadForm : public QDialog 
{ 

Q_OBJECT 

public: 

ThreadForm(QWidget *parent = 0, const char *name = 0); 
protected: 

void closeEvent(QCloseEvent *event); 
private slots: 

void startOrStopThreadA();void startOrStopThreadB(); 
private: 

Thread threadA; 

Thread threadB; 

QPushButton *threadAButton; 

QPushButton *threadBButton; 

QPushButton *quitButton; 

}； 

ThreadForm 클라스는 Thread 형의 2 개 변수와 단추들을 선언 하며 기본사용자대면 부를 제공 
한다 . 

ThreadForm: : ThreadForm(QWidget *parent, const char *name) : QDialog(parent, name) 

{ 

setCaption(tr("Threads")); 

threadA.setMessage("A"); 

threadB.setMessage("B M ); 

threadAButton = new QPushButton(tr( M Start A"), this); 
threadBButton = new QPushButton(tr("Start B”), this); 
quitButton = new QPushButton(tr("Quit"), this); 
quitButton->setDefault(true); 

connect(threadAButton, SIGNAL(clicked()), this, SLOT(startOrStopThreadA())); 
connect(threadBButton, SIGNAL(clicked()), this, SLOT(startOrStopThreadB())); 
connect(quitButton, SIGNAL(clicked()), this, SLOT(close())); 


} 

구성자에서는 setMessageO 을 호출하여 첫 스레드는 " 시를 , 둘째 스레드는 "B " 를 반복 출 




력하게 한다 . 

void ThreadForm: : startOrStopThreadA() 

{ 

if (threadA.runningO) { 
threadA.stop(); 

threadAButton->setText(tr("Start A")); 

} else { 

threadA.start(); 

threadAButton->setText(tr("Stop A")); 

} 

} 

사용자가 스레드 A 용의 단추를 찰칵할 때 startOrStopThreadAO 는 스레드가 실행중에 있으 
면 정지하고 그렇지 않으면 스레드를 기동한다 . 또한 단추의 본문을 갱신한다 . 
void ThreadForm: :startOrStopThreadB() 

{ 

if (threadB .running()) { 
threadB.stop(); 

threadBButton->setText(tr( M Start B")); 

} else { 

threadB.start(); 

threadBButton->setText(tr( M Stop B")); 

} 

} 

startOrStopThreadB() 의 코드는 아주 간단하다 . 
void ThreadForm: :closeEvent(QCloseEvent *event) 

{ 

threadA.stop(); 
threadB. stop(); 
threadA.wait(); 
threadB.wait(); 
event->accept(); 

} 

사용자가 Quit 를 찰칵하거나 창문을 닫으면 실행중에 있는 스레드들을 정지하고 
QCloseEvent::acceptO 를 호출하기전에 그것들이 끝나기를 기다린다 . (QThread::wait() 를 사용한 
다 .：) 이것은 이 실례에서는 문제가 없다하더라도 응용프로그람이 깨끗한 상태에서 완료하도록 
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한다 . 

응용프로그람을 콤파일하려면 .pro 파일에 다음 행을 추가해야 한다 . 

CONFIG += thread 

이것은 qmake 가 Qt 서고의 스레드판을 사용하게 한다 . 스레드화된 Qt 서고를 건설하려면 
-thread 지 령 행 선 택 을 넘 기 여 Unix 와 Mac OS 표에 서 스크립 트환경 을 구성 해 야 한다 . Windows 에 
서 Qt 서고는 기정으로 스레드화된다 . 또한 Windows 의 콘솔에 프로그람의 출력 이 나타나게 하 
려고 하므로 콘솔선택을 요구한다 . 
win32:CONFIG += console 

응용프로그람을 실 행하고 Start A 를 찰칵하면 콘솔은 ’A’ 들로 채워 진다 . Start B 를 찰칵하면 
’A’ 와 방들이 엇바뀌는 렬들이 출력된다 . Stop A 를 찰칵하면 오직 ’묘들이 출력된다 . 

다중스레드 응용프로그람들에 서 일반적 인 요구는 여 러개의 스레드들을 동기시키는것 이다 . 
(가는 이것을 수행하는 QMutex, QMutexLocker, QSemaphore 및 QWaitCondition 클라스들을 제공 
한다 . 

QMutex 클라스는 변수 혹은 코드부분을 보호하는 수단을 제공함으로써 오직 하나의 스레 
드를 한번에 호출할수 있다 . 이 클라스는 뮤텍스를 잠그는 lockO 함수를 제공한다 . 뮤텍스가 
잠그어지지 않았으면 현재 스레드는 곧 그것을 포착하고 잠그며 그렇지 않으면 현재스레드는 
뮤텍스를 보유하는 스레드가 뮤텍스를 열 때까지 차단된다 . 한편 lock () 호출이 돌아올 때 현재 
스레드는 unlock )} 를 호출할 때까지 뮤텍스를 보유한다 . 또한 QMutex 는 뮤텍스가 이미 잠그어 
져 있으면 곧 돌아오는 tryLock () 함수를 제공한다 . 

례를 들면 QMutex 를 가지는 Thread 클라스의 stopped 변수를 보호하려고 한다고 가정하자 . 
그때 Thread 에 다음의 자료성원을 추가한다 . 

QMutex mutex; 

runO 함수는 다음과 같이 변경한다 . 

void Thread: :run() 

{ 

for (；；) { 
mutex.lock(); 
if (stopped) { 
stopped = false; 
mutex.unlock(); 
break; 

} 

mutex.unlock(); 

cerr « messageStr.ascii(); 



cerr « endl; 


} 

stopO 함수는 다음과 같다 . 
void Thread::stop() 

{ 

mutex.lock(); 
stopped = true; 
mutex.unlock(); 

} 

복잡한 함수들 특히 C++ 례외를 사용하는 함수들에서 뮤텍스의 잠건과 열기는 오유를 일 
으키기 쉽 다 . Qt 는 QMutexLocker 편의 클라스를 제공하여 뮤텍스조종을 단순화한다 . 

QMutexLocker 의 구성자는 QMutex 를 인수로 받아들이고 그것을 잠근다 . QMutexLocker 의 해체 
자는 뮤텍스의 잠건을 연다 . 례를 들면 우의 stopO 함수를 다음과 같이 다시 쓴다 . 
void Thread::stop() 

{ 

QMutexLocker locker(&mutex); 
stopped = true; 

} 

^Semaphore 는 (경에서 쎄마퍼를 제공한다 . 쎄마퍼는 뮤텍스의 일반화로서 일정한 수의 동 
일한 자원들을 보호하는데 사용할수 있다 . 

다음 2 개의 코드부분은 QSemaphore 와 QMutex 사이의 대응관계를 보여준다 . 

QSemaphore semaphore(l); QMutex mutex; 

semaphore++; mutex.lock(); 

semaphore--; mutex.unlock(); 

뒤붙이식 ++ 와 --연산자들은 쎄마퍼가 보호하는 하나의 자원을 엄어서 넘겨준다 . 구성자 
에 1 을 넘기여 쎄마퍼에 신호자원을 조종하라고 알린다 . 쎄마퍼사용의 우점은 구성자에 1 을 
넘기고 나를 여러번 호출하여 많은 자원을 얻을수 있는것이다 . 

쎄마퍼 의 전형 적 인 응용은 2 개 스레드들사이 에서 일정한 량의 자료 (DataSize) 를 일정한 크 
기 (BufferSize ) 의 공유원형완충기를 리용하여 전송하는 경우이다 . 
const int DataSize = 100000; 
const int BufferSize = 4096; 
char buffer[BufferSize]; 

생산자스레드는 완충기의 끝에 이를 때까지 자료를 완충기에 써넣고 선두로부터 시작하 
여 현존자료를 덧쓰기 한다 . 소비자스레드는 생성될 때 자료를 읽어들인다 . 그림 17-2 에서는 
아주 작은 16byte 완충기 를 가정 하고 이 것을 설명한다 . 
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freeSpace(11) 
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1 


corsumer producer 


그림 17-2. 생산자-소비자모형 

생산자-소비자실례에서는 동기화의 필요성이 두가지 있다 . 즉 생산자가 자료를 너무 빨리 
생 성 하면 소비 자가 아직 읽어 들이 지 못한 자료를 덧 쓰기 한다 . 소비 자가 자료를 너 무 빨리 읽 
어 들이면 생산자가 아직 채 쓰지 못한 부분까지 도 읽어 들인다 . 

이 문제를 해결하는 원시적인 수법은 생산자가 완충기를 채우게 하고 소비자가 전체 완 
충기를 읽 어들일 때까지 기다리는것 이다 . 그러 나 다중처 리소자콤퓨터들에서 이것은 생산자와 
소비자스레드들이 완충기의 서로 다른 부분들에 대하여 동시 에 조작할만큼 빠르지 못하다 . 

문제를 효과적으로 해결하는 한가지 수법은 2 개의 쎄마퍼를 사용하는것이다 . 

QSemaphore freeSpace(BufferSize); 

QSemaphore usedSpace(BufferSize); 

freeSpace 쎄마퍼는 생산자가 자료를 채울수 있는 완충기 부분을 관리 한다 . usedSpace 쎄마퍼 
는 소비자가 읽어 들일수 있는 령역을 관리한다 . 이 2 개 령역은 보충적 이다 . 둘다 
BufferSize(4096 ) 로 초기 화되 며 이 것은 그렇게 많은 자원을 관리할수 있다는것을 의 미한다 . 

이 실례에서 매 바이트는 하나의 자원으로 계수된다 . 현실세계의 응용프로그람에서는 더 
큰 단위(례를 들면 한번에 64 혹은 256byte ) 에 대하여 조작하여 쎄마퍼사용으로 인한 추가적 
인 부담을 줄이게 한다 . 

void acquire(QSemaphore &semaphore) 

{ 



acquire () 함수는 하나의 자원(완충기의 lbyte ) 을 엄으려고 한다 . QSemaphore 는 여기에 뒤붙 
이식 ++연산자를 사용하지만 우리의 실례에서는 acquire 。 라는 함수를 사용하는것이 더 객관 
적이다 . 

void release(QSemaphore &semaphore) 

{ 

semaphore--; 

} 

마찬가지로 releaseO 함수를 뒤붙이식 --연산자의 동의어로 실현한다 . 
void Producer: :run() 



for (int i = 0;i < DataSize;++i) { 
acquire(freeSpace); 

buffer[i % BufferSize] = "ACGT，，[ (uint)rand() % 4]; 
release(usedSpace); 

} 

} 

생산자에서는 하나의 《자유》바이트를 얻는것으로 시작한다 . 완충기가 소비자가 아직 읽 
지 못한 자료로 꽉 차면 acquire () 호출은 소비자가 자료를 소비하기 시작할 때까지 기다린다 . 
일단 그 바이트를 얻었다면 그것을 우연자료 (’A’,’C’ ， ’G ’， 혹은 ’지로 채우고 그 바이트를《사용 
된》바이트로 풀어놓음으로써 그것을 소비자스레드가 읽을수 있게 한다 . 
void Consumer: :run() 

{ 

for (int i = 0; i < DataSize; ++i) { 
acquire(usedSpace); 
cerr « buffer[i % BufferSize]; 
release(freeSpace); 

} 

cerr « endl; 

} 

소비자에서는 《사용된》바이트를 얻는것으로 시작한다 . 완충기에 읽어들일 자료가 더는 
없으면 acquireO 호출은 생산자가 생성할 때까지 기다린다 . 바이트를 얻었다면 그것을 출력하 
고 바이트를 《자유》바이트로서 풀어놓아 생산자가 다시 자료를 채울수 있게 한다 . 
int main() 

{ 

usedSpace += BufferSize; 

Producer producer; 

Consumer consumer; 
producer.start(); 
consumer. start(); 
producer.wait(); 
consumer. wait(); 
return 0; 

} 

끝으로 main () 에서 QSemaphore 의 비 직 관적인 += 연산자를 리 용하여 《사용된》공간을 모 
두 엄는것으로 시작한다 . 이것은 채 쓰지 않은 부분을 소비자가 읽어들이지 않도록 한다 . 그 
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다음 생산자와 소비자스레드들을 기동한다 . 그때 생기는 현상은 생산자가《자유》공간을《사 
용된》공간으로 변환하고 그다음 소비자는 그것을《자유》공간으로 역변환할수 있다는것이다 . 

프로그람을 실행할 때 콘솔에 100000 개의 ’A’, ’C’, ’G’, T 들의 우연렬을 써넣고 완료한다 . 
그때 수행하는 작업을 리해하기 위하여 출력장치 에 써 넣 기를 금지하고 그대신에 생산자가 바 
이 트를 생성할 때마다 ’P ’ 를 쓰고 소비 자가 바이 트를 읽 을 때마다 V 를 써 넣는다 . 그리 고 될수 
록 간단히 모든 동작이 진행되도록 하기 위하여 DataSize 와 BufferSize 에 훨씬 더 작은 값을 
사용할수 있다 . 

례를 들면 여기에 DataSize 가 10, BufferSize 가 4 일 때 가능한 실행이 있다 . 즉 
’’PcPcPcPcPcPcPcPcPcPc ” 이 다 . 이 경우에 소비 자는 생산자가 바이 트들을 생성할 때마다 곧 읽 
어들이며 2 개의 스레드는 갈은 속도로 실행된다 . 다른 가능성은 소비자가 완충기를 읽기 시 
작하기전에 생산자가 전체 완충기를 채우는것이다 . 즉 "PPPPccccPPPPccccPPcc" 이다 . 다른 가 
능성도 많다 . 쎄마퍼는 체계에 고유한 스레드일정계획기에 많은 자유범위를 준다 . 스레드일정 
계획기는 스레드들의 동작을 탐구하여 최적인 일정계획방략을 선택할수 있다 . 

생산자와 소비자를 동기시키는 문제를 해결하는 다른 수법은 QWaitCondition 과 QMutex 를 
사용하는것이다 . QWaitCondition 은 어떤 조건이 만족될 때 한 스레드가 다른 스레드들을 깨우 
게 한다 . 이것은 오직 뮤텍스들에 의해서만 가능한것보다 더 정확한 조종을 허용한다 . 그 동 
작을 보여주기 위하여 기다림조건들을 사용하여 생산자-소비자실례를 다시 시행한다 . 
const int DataSize = 100000; 
const int BufferSize = 4096; 
char buffer[BufferSize]; 

QWaitCondition bufferlsNotFull; 

QWaitCondition bufferlsNotEmpty; 

QMutex mutex; 
int usedSpace = 0; 

완충기외 에도 2 개의 QWaitCondition, 한개의 QMutex, 그리고 완충기 안에 《사용된》바이 
트가 몇개인가를 보관하는 변수를 하나 선언한다 . 
void Producer: :run() 

{ 

for (int i = 0;i < DataSize;++i) { 
mutex.lock(); 

while (usedSpace = BufferSize) 
bufferIsNotFull.wait(&mutex); 
buffer[i % BufferSize] = "ACGT，，[ (uint)rand() % 4]; 

++usedSpace; 

bufferlsNotEmpty.wakeAllQ; 





mutex.ur 山 ) ck(); 


} 

생산자에서는 완충기가 찼는가 검사하는것으로 시작한다 . 다 찼으면 《완충기가 차지 않 
음》조건이 성립하기를 기다린다 . 조건이 만족되면 완충기에 lbyte 써넣고 usedSpace 를 증가시 
키고 《완충기가 비지 않음》조건이 ttue 로 되기를 기다리는 스레드를 잠재운다 . 

뮤텍스를 사용하여 usedSpace 변수에 대한 모든 호출을 보호한다 . QWaitCondition::wait() 함수 
는 잠건된 뮤텍스를 첫 인수로 가지며 현재 스레드를 차단하기전에 뮤텍스를 돌려준다 . 

이 실례에서는 while 순환 

while (usedSpace = BufferSize) 
bufferIsNotFull.wait(&mutex); 

을 if 문으로 교체한다 . 

if (usedSpace == BufferSize) { 
mutex.unlock(); 
bufferIsNotFull.wait(); 
mutex.lock(); 

} 

그러나 이것은 하나이상의 생산자스레드를 허용하자마자 차단된다 . 그것은 다른 생산자가 
wait() 호출후 곧 뮤텍스를 동결하고《완충기가 차지 않음》조건을 다시 false 로 만들수 있기때 
문이다 . 

void Consumer: :run() 

{ 

for (int i = 0;i < DataSize;++i) { 
mutex.lock(); 
while (usedSpace == 0) 

bufferIsNotEmpty.wait(&mutex); 
cerr « buffer[i % BufferSize]; 

-usedSpace; 

bufferlsNotFull.wakeAllO; 

mutex.unlock(); 

} 

cerr « endl; 

} 

소비자는 생산자와 정반대로 작업한다 . 즉 소비자는《완충기가 비지 않음》조건을 기다리 
며 《완충기가 차지 않음》〉조건을 기다리는 스레드를 깨운다 . 
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지금까지의 모든 실례에서 스레드들은 갈은 대역변수들을 호출하였다 . 그러나 일부 스레 
드응용프로그람들은 서로 다른 스레드들에서 각이한 값을 보유하는 대역변수를 가질 필요가 
있다 . 이것은 흔히 스레드국부기 억 (thread-local storage, TLS) 혹은 스레드고유기 억 (thread-specific 
data, TSD ) 이라고 부론다 . QThread::currentThreadO 로부터 돌아오는 스레드正)들을 건으로 하는 
매프를 리용하여 그것을 꾸밀수 있지만 더 좋은 수법은 QThreadStorage<T > 클라스를 사용하는 
것이다 . 

QThreadStorage<T > 의 일반적 인 용도는 고속완충기억 기 이 다 . 서 로 다른 클라스들에서 제 각 
기 캐쉬를 취함으로써 뮤텍스에서 잠그기 , 열기가 가능한 기다림으로 인한 추가적인 부담을 
피할수 있 다 . 례 를 들면 

QThreadStorage<QMap<int, double〉*> cache; 

void insertIntoCache(int id, double value) 

{ 

if (! cache ,hasLocalData()) 

cache.setLocalData(new QMap<int, double>);cache.localData()->insert(id, value); 

} 

void removeFromCache(int id) 

{ 

if (cache.hasLocalData()) 

cache.localData()->remove(id); 

} 

cache 변수는 스레드마다 QMap<int, double > 의 지적자를 하나 가진다 . (일부 를파일러들에서 
문제가 있으므로 QTlu'eadStorage<T > 에서 형판형은 지적자형이여야 한다 .；) 특정한 스레드에서 
캐 쉬 를 처 음 리 용할 때 hasLocalDataO 는 false 를 돌려 주고 QMap<int, double；"^ 체 를 창조한다 . 

캐슁과 함께 QThreadStorage<T > 는 대역오유상태변수 (toermo 와 비숫하다)에 쓰이며 한개 
스레드에서의 수정 이 다른 스레드들에 영향을 주지 않도록 한다 . 

제2절. GUI 스레드와의 교제 

Qt 응용프로그람이 기동할 때 오직 하나의 스레드 즉 초기스레드가 실행중에 있다 . 이것은 
(^Application 객체를 창조하고 그것에 대하여 exec () 를 호출하게 하는 유일한 스레드이다 . 이러 
한 리유로 보통 이 스레드를 GUI 스레드로 취급한다 . exec () 호출후에 이 스레드는 사건을 기다 
리거 나 사건을 처 리한다 . 

GUI 스레드는 앞 절에서 수행한것처럼 QThread 파생클라스의 객체를 창조하여 새로운 스 
레드들을 기동할수 있다 . 새로운 스레드들은 서로 교제할 필요가 있으면 뮤텍스，쎄마퍼 혹은 
기다림조건들과 함께 공유변수들을 사용할수 있다 . 그러나 이 기술은 사건순환고리를 잠그고 
사용자대면부를 동결할수 있으므로 GUI 스레드와 교제하는데 사용할수 없다 . 

비 GUI 스레드가 GUI 스레 드와 교제하기 위한 대 책은 사용자정 의사건들을 사용하는것 이 다 . 



(가의 사건기구는 기본형과 함께 사용자정의사건형들을 정의하고 QApplication :: postEvent () 를 리 
용하여 이 형의 사건들을 발송할수 있다. 더우기 postEventO 가 스레드에 안전하므로 임의의 
스레드로부터 이 함수를 리용하여 GUI 스레드에로 사건을 발송할수 있다. 



그림 17-3. Image Pro 응용프로그람 

그 동작을 설명하기 위하여 사용자가 화상의 회전, 크기조절，색깊이변경을 가능하게 하 
는 기본화상처 러프로그람인 Image Pro 의 코드를 고찰한다. 응용프로그람은 비 GUI 스레드를 리 
용하여 사건순환고리를 잠그지 않고 화상에 대한 조작을 수행한다. 이것은 큰 화상을 처리할 
때 크게 차이난다. 비 GUI 스레 드는 수행 해 야 할 과제 또는《일 괄처 리》들의 목록을 가지 며 사 
건들을 기본창문에 보내여 진척상황을 알린다. 

ImageWindow : : ImageWindow(QWidget * parent , const char * name ) 

: QMainWindow ( parent , name ) 

{ 

thread . setTargetWidget ( this ); 


} 

Image Window 구성자에서는 비 GUI 스레드의 《목표창문부품》를 ImageWindow 로 설정한다. 
이 스레드는 그 창문부품에 진척상황사건들을 발송한다. 스레드변수는 TransactionThread 형이 
다. 그것을 간단히 설명한다. 

void ImageWindow :: flipHorizontally () 

{ 

addTransaction(new FlipTransaction ( Horizontal )); 

} 

flipHorizontallyO 처 리 부는 FlipTransaction 을 창조하고 비 공개 함수 addTransaction () 을 사용하 








여 그것을 등록한다 . flipVerticalO, resizelmage(), convertTo32Bit(), convertTo8Bit(), convertTolBit() 
함수들도 비슷하다 . 

void Image Window::addTransaction(Transaction * transact) 

{ 

thread.addTransaction(transact); 
openAct->setEnabled(false); 
saveAct->setEnabled(false); 
saveAsAct->setEnabled(false); 

} 

addTransaction() 함수는 일괄처 리 를 비 GUI 스레 드의 일괄처 리 기 다림렬 에 추가하고 일괄처 리 
들을 처 리 하는동안 Open, Save, Save As 작용을 금지 한다 . 
void ImageWindow::customEvent(QCustomEvent * event) 

{ 

if ((int)event->type() = TransactionStart) { 

TransactionStartEvent *startEvent = (TransactionStartEvent *)event; 
infoLabel->setText(startEvent->message); 

} else if ((int)event->type() == AllTransactionsDone) { 
openAct->setEnabled(true); 
saveAct->setEnabled(true); 
save As Act->setEnabled(true); 
imageLabel->setPixmap(QPixmap(thread.image())); 
infoLabel->setText(tr("Ready n )); 
modLabel->setText(tr("MOD n )); 
modified = true; 

statusBar()->message(tr("Done M ), 2000); 

} else { 

QMainWindow: : customEvent(event); 

} 

} 

customEvent() 함수는 사용자정의사건들을 처 리 할수 있게 QObject 로부터 재정의된다 . Transa 
ctionStart 와 AllTransactionsDone 상수들은 transactionthread.h 에서 다음과 같이 정의된다 . 
enum { TransactionStart = 1001, AllTransactionsDone = 1002 }; 

Qt 의 기본사건들은 1000 아래의 값을 가전다 . 더 큰 값들은 사용자정의사건들에 사용될수 
있다 . 

사용자정의사건들의 자료형은 사건형과 함께 void 지적자를 보관하는 QEvent 의 파생클라 




스 QCustomEvent 이다 . TransactionStart 사건들에 서는 추가자료성원을 보관하는 QCustomEvent 의 
파생클라스를 사용한다 . 

class TransactionStartEvent : public QCustomEvent 

{ 

public: 

TransactionStartEvent(); 

QString message; 

}； 

TransactionStartEvent::TransactionStartEvent() : QCustomEvent(TransactionStart) {} 

구성 자에 서 는 TransactionStart 상수를 기 초클라스구성 자에 넘 긴 다 . 

그러 면 TransactionThread 클라스를 고찰하자 . 
class TransactionThread : public QThread 

{ 

public: 

void run(); 

void setTargetWidget(QWidget *widget); 
void addTransaction(Transaction ^transact); 
void setImage(const Qlmage &image); 

Qlmage image(); 
private: 

QWidget *targetWidget; 

QMutex mutex; 

Qlmage currentlmage; 

std: :list<Transaction *> transactions; 

}； 

TransactionThread 클라스는 배경에서 일괄처리들을 하나씩 처리하고 실행하기 위하여 일괄 
처리의 목록을 유지관리한다 . 

void TransactionThread :: addTransaction(Transaction * transact) 

{ 

QMutexLocker locker(&mutex); 
transactions.push_back(transact); 
if (!running()) 
start(); 

} 

addTransactionG 함수는 일 괄처 리 기 다림렬 에 일 괄처 리 를 추가하고 그것 이 이 미 실 행 중에 있 




지 않으면 일괄처리스레드를 기동한다 . 

void TransactionThread: : run() 

{ 

Transaction *transact; 
for ( ； ； ) { 
mutex.lock(); 

if (transactions.emptyO) { 
mutex.unlock(); 
break; 

} 

Qlmage oldlmage = currentlmage; 
transact = *transactions.begin(); 
transactions.pop_front(); 
mutex.unlock(); 

TransactionStartEvent *event = new TransactionStartEvent; 
event->message = transact->messageStr(); 

QApplication: : postEvent(targetWidget, event); 

Qlmage newlmage = transact->apply(oldlmage); 

delete transact; 

mutex.lock(); 

currentlmage = newlmage; 
mutex.unlock(); 

} 

QApplication: : postEvent(targetWidget, new QCustomEvent(AllTransactionsDone)); 

} 

mn() 함수는 일괄처 리기 다림렬을 순환하면서 apply() 를 호출하여 매개 일괄처 리 를 차례로 
실행한다 . 일괄처 리들과 currentlmage 성원변수에 대한 모든 호출은 뮤텍스에 의해 보호된다 . 

일괄처리가 기동할 때 TransactionStart 사건을 목표창문부품 (ImageWindow) 에 발송한다 . 모 
든 일괄처리가 처리를 완료하였을 때 AllTransactionsDone 사건을 발생한다 . 
class Transaction 
{ 

public: 

virtual Qlmage apply(const Qlmage &image) ?= 0; 
virtual QString messages 仕 () = 0; 


}； 



Transaction 클라스는 사용자가 화상에 대하여 조작하는 추상기초클라스이다 . 이것은 3 개의 
파생클라스 FlipTransaction, ResizeTransaction, ConvertDepthTransaction 을 가진다 . FlipTransaction 
만 고찰하는데 다른 2 개 클라스들은 비슷하다 . 

class FlipTransaction : public Transaction 

{ 

public: 

FlipTransaction(Qt::Orientation orient); 

Qlmage apply(const Qlmage &image); 

QString messageStr(); 

private: 

Qt: : Orientation orientation; 

}； 

FlipTransaction 구성자는 방향 (Horizontal 혹은 Vertical) 을 지정 하는 하나의 과라메 터를 가진 
다 . 

Qlmage FlipTransaction: : apply (const Qlmage &image) 

{ 

return image.mirror(orientation = Qt::Horizontal, orientation == Qt::Vertical); 

} 

a PPly () 함수는 파라메터로 받아들이는 Qlmage 에 대하여 Qlmage::mirror() 를 호출하고 결과 
Qlmage 를 돌려준다 . 

QString FlipTransaction: : messageStr() 

{ 

if (orientation == Qt::Horizontal) 

return QObject: : tr("Flipping image horizontally..."); 

else 

return QObject: : tr("Flipping image vertically..."); 

} 

messageStr() 는 조작이 진행되 는 동안 상태띠 에 표시 할 통보문을 돌려준다 . 이 함수는 
Image Window: : customEvent() 와 GUI 스 레드 에서 호출된 다 . 

실행이 오래 걸리는 조작들에서는 진척상황을 알릴 필요가 있다 . 추가적인 사용자정의사 
건을 창조하고 일정한 퍼센트의 처리가 끝나면 그것을 발송함으로써 수행할수 있다 . 

제3절. 비 GUI 스레드들에서 Qt 클라스들의 사용 

함수는 서로 다른 스레드들로부터 동시에 안전하게 호출할수 있을 때 스레드안전함수라 
고 말한다 . 2 개의 스레드안전함수를 서로 다른 스레드들로부터 갈은 공유자료에 대하여 호출 
한다면 결과가 늘 정의된다 . 더 확장하여 클라스는 그의 모든 함수들이 서로 다른 스레드들 



로부터 지어는 같은 객체에 대하여 조작할 때에도 서로 간섭하지 않고 동시에 호출할수 있을 
때 스레드안전클라스라고 말한다 . 

Qt 의 스레드안전클라스들은 QThread, QMutex, QMutexLocker, QSemaphore, QThreadStorage 
<T> 및 QWaitCondition 이다 . 또한 다음의 함수들은 스레드안전함수이다 . 즉 QApplication: : postE 
vent(), QApplication::removePostedEvents(), QApplication::removePostedEvent() 및 QEventLoop: : wak 
eUp(). 

Qt 의 대다수 비 GUI 클라스들은 좀 엄격 한 요구를 만족시켜 야 한다 . 그것은 재입구가능 
이 다 . 클라스의 각이 한 실 례 들을 각이 한 스레 드들에 서 동시 에 사용할수 있으면 그 
클라스는 재입구가능이다 . 그러 나 여러 스레드들사이 에서 동시 에 갈은 재입구가능객체를 호 
출하는것 은 안전하지 못하고 그러한 호출은 뮤텍 스에 의 해 보호되 여 야 한다 . 재입 구가눙클라 
스들은 Qt 참고문서에서와 같이 표식된다 . 일반적으로 대역적으로 참고하지 않는 임의의 C++ 
클라스 혹은 공유자료는 재입 구가능이 다 . 

QObject 는 재 입 구가능이 지 만 Qt 의 어 느 QObject 파생 클라스도 재 입 구가능이 아니 다 . 이 로 
부터 얻어지는 하나의 결론은 비 GUI 스레드로부터 창문부품에 대하여 함수들을 직 접 호출할 
수 없다는것이다 . 비 GUI 스레드로부터 QLabel 의 본문을 변경하려고 한다면 사용자정의사건을 
GUI 스레드에 발송하여 본문을 변경할것을 요구해야 한다 . 

delete 에 의한 QObject 삭제 는 재입 구가능이 아니 다 . 비 GUI 스레 드로부터 QObject 를 삭제하 
기 위 하여 《기한부삭제》사건을 발송하는 QObject :: deleteLater() 을 호출해야 한다 . 

QObject 의 신호-처리부기구는 임의의 스레드에서 사용될수 있다 . 신호가 한개 스레드에서 
발생될 때 거기에 련결된 처리부들은 즉시 호출되고 실행은 갈은 스레드에서 발생하고 수신 
자객체가 창조되는 스레드에서는 발생하지 않는다 . 이것은 신호와 처리부를 사용하여 다른 
스레 드들로부터 GUI 스레 드와 교제 할수 없 다는것 을 의 미한다 . 

QTimer 클라스와 망프로그람작성 클라스 QFtp, QHttp, QSocket, 및 QSocketNotifier 는 모두 사 
건순환고리에 의존하므로 비 GUI 스레드에서 사용할수 없다 . 유효한 단 하나의 망구축클라스는 
가동환경 에 고유한 망구축 API 들을 위 한 저 수준래 퍼 로서 QSocketDevice 이 다 . 일 반적 인 기 술은 
비 GUI 스레드에서 동기 QSocketDevice 를 사용하는것이다 . 일부 프로그람작성자들은 QSocket (비 
동기적 으로 작업한다.)를 사용하는 경 우보다 코드를 더 단순하게 한다는것 을 발견 하고 비 GUI 
스레 드에 서 작업함으로써 사건순환고리 를 차단하지 않는다 . 

또한 Qt 의 SQL 과 OpenGL 모듈은 다중스레드응용프로그람들에서 쓰일수 있으나 체계에 
따라 변하는 자체의 제한을 가지고있다 . 

Qlmage, QString, 용기 클라스들을 비롯한 (가의 대다수 비 GUI 클라스들은 최적화기술로서 
암시적 혹은 명시적공유를 사용한다 . 이 클라스들은 복사구성자와 대입연산자들을 제외하고 
재입구가능이다 . 이려한 클라스들의 실례의 사본을 취할 때 오직 내부자료의 지적자가 복사 
된다 . 이것은 여러개의 스레드들이 자료를 동시에 수정하려고 하는 경우에는 위험하다 . 그러 
한 경우에 해결책은 암시적 혹은 명시적으로 공유된 클라스의 실례에 대입을 할 때 



QDeepCopy<T > 클라스를 사용하는것이다 . 례를 들면 
QString password; 

QMutex mutex; 

void setPassword(const QString &str) 

{ 

mutex.lock(); 

password = QDeepCopy<QString>(str); 
mutex.unlock(); 



제 18 장. 가동환경에 고유한 기능 


이 장에서는 Qt 프로그람작성자에게 유효한 가동환경에 고유한 일부 선택을 고찰한다 . 우 
선 Windows 에서 Win32 API, Mac OS 표에서 Core Graphics, XII 에서 Xlib 와 같은 API 들을 호출하 
는 방법을 고찰한다 . 그다음 여의 ActiveQt 확장을 조사하고 Qt/Windows 응용프로그람들에서 
ActiveX 조종요소들의 사용법과 ActiveX 봉사기들에서 동작하는 응용프로그람들을 창조하는 방 
법을 보여준다 . 그리고 마지막 절에서는 XII 하에서 Qt 응용프로그람들이 쎄손관리기와 협동하 
는 방법을 설명한다 . 

여기서 제시하는 기능들과 함께 Qt Enterprise 판에는 Motif 와 Xt 응용프로그람들을 (가에 간 
단히 옮기 게 하는 Qt/Motif 확장이 포함되 여있다 . Tcl/Tk 응용프로그람용의 비 숫한 확장을 
froglogic 가 제공하며 Microsoft Windows 자원 변환기를 Klaralvdalens Datakonsult 로부터 사용할수 
있다 . 그리고 매몰판개발을 위 하여 Trolltech 는 Qtopia 응용프로그람틀거리를 제공한다 . 

제1절. 원시적인 API 들고ᅡ의 대면 

Qt 는 모든 가동환경에서 대부분의 요구를 만족시키는 포괄적인 API 들을 제공한다 . 그러 
나 일부 환경에서는 기초하고있는 가동환경에 고유한 API 들을 사용하려고 할수 있다 . 이 절 
에서는 특별한 과제를 수행하기 위하여 Qt 가 제공하는 각이한 가동환경들에서 원시적인 API 
들을 사용하는 방법을 보여준다 . 

매개 가동환경에서 QWidget 는 창문 ID(Windows 에서 HWND) 를 돌려주는 winld() 함수를 제 
공한다 . 또한 QWidget 는 특별 한 창문 ID 를 가지 는 QWidget 를 돌려 주는 fmd() 라는 정 적 함수를 
제공한다 . 이 ID 를 원시 API 함수들에 넘기여 가동환경에 고유한 효과를 엄는다 . 례를 들면 다 
음의 코드는 winld() 를 사용하여 원시 Core Graphics 함수들 (Qt 3.3 은 원시 API 호출에 의 거 하지 않 
고도 이것을 달성하는 함수를 제공한다.：)을 리용하여 Mac OS 표에서 QLabel 을 반투명으로 만 
든다 . 


#include <qapplication.h> 

#include <qlabel.h> 

#include <qt_mac.h> 

int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

QLabel *label = new QLabel("Hello Qt! M , 0); 
app.setMainWidget(label); 

CGSWindowRef winRef = GetNativeWindowFromWindowRef((WindowRef)label->winId()); 

CGSSetWindowAlpha(_CGSDefaultConnection(), winRef, 0.5); 

label->show(); 





return app.exec(); 

} 

여기에 Win32 API 를 사용하여 Windows 에서 같은 효과를 얻는 방법이 있다 . 

#defme _WIN32_WINNT 0x0501 
#include <qapplication.h> 

#include <qt_windows.h> 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 

QLabel *label = new QLabel("Hello Qt! M , 0); 
app.setMainWidget(label); 

int exstyle = GetWindowLong(label->winId(), GWL_EXSTYLE); 
exstyle |= WS_EX_LAYERED; 

SetWindowLong(label->winId(), GWL_EXSTYLE, exstyle); 
SetLayeredWindowAttributes(label->winId(), 0, 128, LWA ALPHA); 

Label->show(); 
return app.exec(); 

} 

이 코드는 가동환경 이 Windows 2000 혹은 XP 라는것을 전제로 한다 . 반투명기능을 유지하 
지 않는 낡은 판의 Windows 에서 응용프로그람을 콤파일하고 실행하려고 한다면 QLibrary 를 
사용하여 련결시 가 아니 라 실 행 시 에 SetLayeredWindowAttributes 기 호를 해 결 할수 있다 . 
typedef BOOL ( _ stdcall *PSetLayeredWindowAttributes) 

(HWND, COLORREF, BYTE, DWORD); 

PSetLayeredWindowAttributes pSetLayeredWindowAttributes = 

(PSetLayeredWindowAttributes) QLibrary: : resolve( M user32 M , "SetLayeredWindowAttributes"); 
if (pSetLayeredWindowAttributes) { 

int exstyle = GetWindowLong(label->winId(), GWL_EXSTYLE); 
exstyle |= WS_EX_LAYERED; 

SetWindowLong(label->winId(), GWL_EXSTYLE, exstyle); 
pSetLayeredWindowAttributes(label->winId(), 0, 128, LWA ALPHA); 

} 

Qt/Windows 는 이 기술을 내적으로 사용하여 Qt 응용프로그람들이 본래의 유니코드유지와 
효과적인 서체변환과 갈은 고급한 기능의 우점들을 리용하며 여전히 Windows 의 낡은 판들에 
서 실행할수 있도록 한다 . 

XII 에서 투명성을 얻는 표준방법은 없다 . 그러나 여기에 XII 창문속성을 수정하는 방법이 
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效다 . 


Atom atom = XIntemAtom(win->xl lDisplay(), "MY 一 PROPERTY”, False); 
long data = 1; 

XChangeProperty(win->x 11 Display(), win->winld(), atom, atom, 32, PropModeReplace, 
(unsigned char *)&data, 1); 

Qt/Embedded 는 원시 API 없이 Linux 틀완충기에 직접 실현하는 (가판들과 다르다 . 또한 자체 
의 창문체계 QWS 를 제공한다 . 이것은 QWSDecoration 과 QWSInputMethod 와 같은 Qt/Embedded 
에 고유한 클라스들의 파생클라스를 만둠으로써 구성될수 있다 . Qt/Embedded 의 다른 한가지 
차이는 사용하지 않은 클라스들과 기능들을 콤파일하지 않음으로써 크기를 줄일수 있다는것 
이다 . 

다른 이식가능한 Qt 응용프로그람에서 가동환경 에 고유한 코드를 사용하려고 한다면 원시 
코드를 #if 와 #endif 안에 넣을수 있다 . 례를 들면 


#if defined(Q_WS_MAC) 

CGSWindowRef winRef = GetNativeWindowFromWindowRef((WindowRef)label->winId()); 
CGSSetWindowAlpha(_CGSDefaultConnection(), winRef, 0.5); 

#endif 


어는 다음 4 가지 창문체계기호 즉 Q_WS_WIN, Q_WS_X11, Q_WS_MAC 그리고 
Q_WS_QWS 를 정의한다 . 응용프로그람들에서 이 기호들을 사용하기전에 적어도 하나의 Qt 머 
리부에서 포함한다는것을 확인해야 한다 . 또한 (가는 조작체계를 식별하기 위한 앞처리기기호 
들을 제공한다 . 즉 


Q_OS_WIN32 
Q_OS 一 WIN64 
Q_OS_CYGWIN 
Q_OS 一 MAC 
Q_OS 一 AIX 


Q_OS_DGUX 
Q_OS 一 DYNIX 
Q_OS_FREEBSD 
Q_OS_HPUX 
Q_OS_HURD 


Q_OS_LINUX 

Q_OS_LYNX 

Q_OS_NETBSD 

Q_OS_OPENBSD 

Q_OS_OSF 


Q_OS_QNX6 
Q_OS_RELIANT 
Q_OS 一 SCO 
Q_OS_SOLARIS 
Q_OS_ULTRIX 


Q_OS 一 BSDI Q_OS_IRIX Q_OS_QNX Q_OS_UNIXWARE 

대체로 이 기호들중 하나가 정의된것으로 가정할수 있다 . 편리상 Qt 는 Win32 나 Win64 가 
탐지 되 면 0_OS_WIN 을 정 의 하고 Unix 기 반조작체 계 (Mac OS X 포함)가 탐지 되 면 0_OS_UNK 를 
정의한다 . 실행시에 QApplication: : winVersion() 혹은 QApplication::macVersion() 을 호출하여 각이 
한 판의 Windows (95, 98, 등 ) 혹은 Mac OSX (10.0, 10.1, 등)을 구별 할수 있다 . 

어의 일부 GUI 관련클라스들은 객체에로의 저수준핸들을 돌려주는 가동환경에 고유한 
handle() 함수를 제공한다 . 표 18-1 은 각이한 가동환경 에서 handle() 의 돌림값형을 보여준다 . 

표 18-1. 가동환경에 고유한 핸들형 



Windows 

Xll 

Mac OS X 

Embedded 

QCursor 

HCURSOR 

Cursor 

int 

int 
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Windows 

Xll 

Mac OS X 

Embedded 

QFont 

HFONT 

Font 

FMFontFamily 

FontID 

QPaintDevice 

HDC 

Drawable 

GWorldPtr 


QPainter 

HDC 

Drawable 

GWorldPtr 


QRegion 

HRGN 

Region 

RgnHandle 

void * 

QSessionManager 


SmcConn 




QWidget, QPixmap, QPrinter 및 QPicture 클라스들은 모두 QPaintDevice 를 계승한다 . XII 과 
Mac OS X 에서 handle() 은 QWidget 에서 winld() 와 같은것을 의미한다 . Windows 에서 handle() 은 
장치상황을 돌려주며 winldO 는 창문핸들을 돌려준다 . 마찬가지로 QPixmap 는 Windows 에서 비 
트매 프핸들 (HBITMAP) 을 돌려주는 hbm() 함수를 제 공한다 . 

XII 에서 QPaintDevice 는 여러가지 지적자들이나 핸들을 돌려 주는 많은 함수들 
(xllDisplay() 와 xllScreen() 등)을 제공한다 . 례를 들면 이 함수들을 사용하여 QWidget 혹은 
QPixmap 에 대하여 XII 그라픽스상황을 설정한다 . 

다른 도구묶음들이나 서 고들과 자주 대 면 해 야 하는 Qt 응용프로그람들은 저 수준사건들 
(XII 에서 XEvent 들 , Windows 와 Mac OS 표에서 MSG 들 , Qt/Embedded 에서 QWSEvent 들)이 
QEvent 들로 변환되기전에 호출할 필요가 있다 . (^Application 의 파생클라스를 만들고 가동환경 
에 고유한 관련사건려과기 (winEvenffilter(), xllEventFilter(), macEventFilter(), 및 qwsEventFilter() 
중의 하나)를 재정의하여 이것을 수행할수 있다 . 

winEvent(), xllEvent(), macEvent() 그리 고 qwsEvent() 중의 하나를 재정의함으로써 주어 진 
QWidget 에 송신되는 가동환경에 고유한 사건들을 호출할수 있다 . 이것은 오락조종기구의 사 
건들과 같이 보통 Qt 가 무시하는 일정한 형의 사건들을 조종하여 사용할수 있다 . 

제2절. ActiveX 으| 사용 

Microsoft 의 ActiveX 기술은 응용프로그람들이 다른 응용프로그람이나 서고들에 의하여 제 
공되는 사용자대면부 부분품들을 결합하게 한다 . 이것은 Microsoft COM 우에 구축되고 부분품 
들을 사용하는 응용프로그람들의 대 면부모임 과 부분품들을 제 공하는 응용프로그람과 서 고들 
의 대 면 부모임 을 정 의한다 . 

QtAVindows Enterprise 판은 ActiveX 와 (가를 원만히 결합하는 ActiveQt 틀거리를 제공한다 . 
ArtiveQt 는 2 개의 모듈로 이루어진다 . 즉 

- 分切모듈은 Qt 응용프로그람들에서 COM 객체들을 사용하게 하고 ActiveX 조종요 
소들을 매몰하게 한다 . 

- 分切 rer 모듈은 Qt 로 쓴 사용자정 의 COM 객 체 들과 ActiveX 조종요소들을 반출하게 한다 . 

첫 실례는 QAxContainer 를 리용하여 Qt 응용프로그람에 Windows Media Player 를 매몰하게 

한다 . Qt 응용프로그람은 Windows Media Player Ac 仕 veX 조종요소에 단추， P!ay/Pause 단추， 




단추 그리고 미끄럼띠를 추가한다 . 



그림 18-1. Media Player 응용프로그람 
응용프로그람의 기본창문은 PlayerWindow 형 이 다 . 
class PlayerWindow : public QWidget 
{ 

Q_OBJECT 

Q_ENUMS(ReadyStateConstants) 

public: 

enum PlayStateConstants { Stopped = 0, Paused = 1， Playing = 2 }; 
enum ReadyStateConstants { Uninitialized=0, Loading=l, Interactive=3, Complete=4 }; 
PlayerWindow(QWidget *parent = 0, const char *name = 0); 
protected: 

void timerEvent(QTimerEvent *event); 
private slots: 

void onPlayStateChange(int oldState, int newState); 
void onReadyStateChange(Ready StateConstants ready State); 
void onPositionChange(double oldPos, double newPos); 
void sliderValueChanged(int newValue); 
void openFileO ； 

PlayerWindow 클라스는 QWidget 를 계승한다 . Q_ENUMS() 마크로는 moc 에 onReadyStateChan 
ge() 처 리 부에 서 사용한 Ready StateConstants 형 이 렬거 형이 라는것 을 알리 는데 필 요하다 . 
private: 

QAxWidget *wmp; 

QToolButton *openButton; 

QToolButton *playPauseButton; 







QToolButton *stopButton; 
QSlider *seekSlider; 
QString fileFilters; 
int updateTimer; 


}； 

비 공개 절 에서 는 QAxWidget* 자료성 원을 선 언 한다 . 

PlayerWindow :: PlayerWindow(QWidget ^parent, const char *name) : QWidget(parent, name) 

{ 


wmp = new QAxWidget(this); 

wmp->setControl( ,, {22D6F312-B0F6-llD0-94AB-0080C74C7E95 } ,, )； 

구성 자에서 는 QAxWidget 객 체 를 창조하여 Windows Media Player ActiveX 조종요소를 매 몰한 
다 . gAxCbwtoVzer 모둘은 3 개의 클라스들로 이루어진다 . 즉 QAxObject 는 COM 객체를， 
QAxWidget 는 ActiveX 조종요소를 각각 밀봉하며 QAxBase 는 QAxObject 와 QAxWidget 의 핵심 
COM 기능을 실현한다 . 

QAxBase QWidget 

— 1 - 1 I 

QAxObject QAxWidget 

그림 18-2. QAxContainer 모듈의 계 승나무 

Windows Media Player 6.4 조종요소의 클라스 ID 를 가지 고 QAxWidget 에 대 하여 setConttol() 를 
호출한다 . 이것은 필요한 부분품의 실례를 창조한다 . 그다음 ActiveX 조종요소의 모든 속성，사 
건 및 메쏘드들을 QAxWidget 객체를 통하여 Qt 속성，신호 및 처리부들처럼 사용할수 있다 . 

COM 자료형들은 표 18-2 에 요약한것처럼 대응하는 Qt 형들로 자동적으로 변환된다 . 례를 
들면 VARIANT_BOOL 형의 항목파라메 터는 bo 이로 , VARIANT_BOOL 형의 출구파라메 터는 bool 
&로 된다 . 결과형 이 Qt 클라스 (QS 仕 ing, QDateTime 등)이 면 항목파라메터는 const 참고(례를 들면 
const QString &) 이 다 . 


표 18-2. COM 형 과 Qt 형 들사이 의 관계 


COM 자료형 

Qt 자료형 

VARIANT_BOOL 

bool 

char, short, int, long 

int 

unsigned char, unsigned short, 

unsigned int, unsigned long 

uint 

float, double 

double 

CY 

Q_LLONG 

BST 

QString 
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COM 자료형 

Qt 자료 형 

DATE 

QDateTime 

OLE_COLOR 

QColor 

SAFEARRAY(VARIANT) 

QValueList<Q Variant 〉 

SAFEARRAY(BYTE) 

QByteArray 

VARIANT 

QVariant 

IFontDisp * 

QFont 

IPictureDisp * 

QPixmap 


Qt 자료형들을 가지는 QAxObject 혹은 QAxWidget 에서 사용할수 있는 모든 속성，신호 및 
처 리 부들의 목록을 얻 으려 면 generateDocumentationO 을 호출하거 나 (가의 

extensions\activeqt\example 등록부에 배치되 여 있는 (가의 dumpdoc 지 령 행도구를 사용해 야 한다 . 
wmp->setProperty("ShowControls", QVariant(false, 0)); 
wmp->setSizePolicy(QSizePolicy :: Expanding, QSizePolicy: : Expanding); 
connect(wmp ? SIGNAL(PlayStateChange(int, int)), this, SLOT(onPlayStateChange(int, int))); 
connect(wmp, SIGNAL(ReadyStateChange(ReadyStateConstants)), this, 
SLOT(onReadyStateChange(ReadyStateConstants))); 
connect(wmp, SIGNAL(PositionChange(double, double)), this, 

SLOT(onPositionChange(double, double))); 

자체의 단추들을 제공하여 부분품을 조작하므로 PlayerWindow 구성자에서는 setControl() 호 
출후에 setProperty() 를 호출하여 Windows Media Player 의 ShowControls 속성을 false 로 설정 한다 . 
setPropertyf} 함수는 QObject 에서 정의되고 COM 속성들과 표준 Qt 속성들에서 모두 사용할수 있 
다 . 함수의 둘째 파라메터는 (^Variant 형이다 . 일부 C++ 콤파일러들은 아직 bool 형속성을 유지하 
지 않으므로 bool 을 가지는 QVariant 구성자는 무익한 int 파라메터도 가진다 . bool 외의 형들은 
(^Variant 로 자동변환된다 . 

다음으로 setSizePolicyO 를 호출하여 ActiveX 조종요소가 배치관리자의 유효공간을 모두 차 
지하도록 하고 COM 부분품으로부터 3 개의 처리부에 3 개의 ActiveX 사건을 련결한다 . 

PlayerWindow 구성자의 나머지 부분은 보통의 견본을 따르지만 일부 Qt 신호를 COM 객체가 
제공하는 처리부들 (Play(),Pause() 그리고 Stop()) 에 련결하는것만 다르다 . 

timerEventO 함수를 고찰하자 . 

void PlayerWindow::timerEvent(QTimerEvent *event) 

{ 

if (event->timerld() = updateTimer) { 

double curPos = wmp->property( n CurrentPosition n ).toDouble(); 
onPositionChange (- 1, curPos); 

} else { 
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QWidget: : timerEvent(event); 


} 

} 

timerEventO 함수는 매체의 부분을 재생하는동안 규칙적인 시격으로 호출된다 . 그것을 리 
용하여 미끄럼띠를 전진시킨다 . 이것은 ActiveX 조종요소에 대하여 propertyO 를 호출하여 
Curren 任 5 osition 속성의 값을 QVariant 로서 얻고 toDoubleO 를 호출하여 double 로 변환하는 방법 으 
로 수행한다 . 그다음 onPositionChangeO 를 호출하여 갱 신 한다 . 

대부분의 코드는 ActiveX 와 직 접 련관되 여있지 않으므로 나머 지 코드를 고찰하지 않는다 . 

分모듈과 련결하기 위하여서는 .pro 파일에 다음의 항목이 필요하다 . 

LIBS 寒 M -lqaxcontainer 

COM 객체들을 취급할 때 자주 필요한것은 COM 메쏘드를 직접 호출할수 있게 하는것이다 . 
(이것은 Qt 신호에 련결하는것과 반대이다 .：) 이것을 수행하는 가장 쉬운 방법은 첫 파라메터로 
서 메쏘드의 이름과 서명을 , 추가파라메터로서 메쏘드의 인수들을 넘기여 dynamicCallO 를 호 
출하는것이다 . 례를 들면 

wmp->dynamicCall("TitlePlay(uint)", 6); 

dynamicCallO 함수는 QVariant 형의 8 개 파라메 터를 가지며 QVariant 를 돌려 준다 . 이려한 방 
법으로 IDispatch * 혹은 IUnknown *를 넘기려고 한다면 QAxObject 에 부분품을 밀봉하고 그것 
에 대하여 asVariant() 를 호출하여 QVariant 로 변환할수 있다 . IDispatch * 나 IUnknown* 를 돌려 
주는 COM 메 쏘드를 호줄하거나 그 형들중의 하나의 COM 속성을 호줄해야 한다면 그대신 
querySubObject() 를 사용해 야 한다 . 

QAxObject * session = outlook.querySubObject(" Session"); 

QAxObject *defau!tContacts = 

session->querySubObject("GetDefaultFolder(01DefaultFolders)", "olFolderContacts ")； 

유지되지 않은 자료형들을 파라메터목록에 넘기여 함수들을 호출하려고 한다면 
QAxBase :: querylnterface()l- 사용하여 COM 대면부를 얻고 직접 함수를 호출한다 . 대면부를 리 
용하여 완료했을 때 ReleaseO 를 호출해야 한다 . 

그러한 함수들을 자주 호출해 야 한다면 QAxObject 나 QAxWidget 의 파생 클라스를 만들고 
COM 대면부호출들을 밀봉하는 성원함수들을 제공할수 있다 . 그러나 QAxObject 와 QAxWidget 
의 파생 클라스들이 자체 의 속성 , 신호 , 처 리 부들을 정 의할수 없다는것 을 알아야 한다 . 

그러면 QAxServer 모듈을 고찰하자 . 이 모듈은 표준 Qt 프로그람을 ArtiveX 봉사기로 절환할 
수 있게 한다 . 봉사기는 공유서고 혹은 독립적인 응용프로그람일수 있다 . 공유서고로 구축된 
봉사기 들은 흔히 프로쎄 스내 봉사기 (in-process server) 라고 부르며 독립 적 인 응용프로그람들은 
프로쎄 스외 봉사기 (out-of-process server) 라고 부론다 . 

처음의 QAxServer 실례는 프로쎄스내봉사기로서 좌우로 튀는 공을 표시하는 창문부품을 
제 공한다 . 또한 창문부품을 Internet Explorer 에 매 몰하는 방법 을 보여 준다 . 




여기에 AxBouncer 창문부품클라스정의의 앞부분이 있다 . 
class AxBouncer : public QWidget, public QAxBindable 
{ 

Q_OBJECT Q_ENUMS(Speed) 

Q_PROPERTY(QColor color READ color WRITE setColor) 

Q_PROPERTY(Speed speed READ speed WRITE setSpeed) 

Q_PROPERTY(int radius READ radius WRITE setRadius) 

Q PROPERTY(bool running READ isRunning) 

AxBouncer 는 QWidget 와 QAxBindable 를 둘다 계승한다 . QAxBindable 클라스는 창문부품과 
ActiveX 의뢰기사이의 대면부를 제공한다 . 임의의 QWidget 를 ActiveX 조종요소로서 반출할수 있 
으나 QAxBindable 의 파생클라스를 만들어서 속성값이 변할 때 의뢰기 에 통지 할수 있으며 
COM 대면부를 실현하여 QAxServer 에 의하여 이미 실현된것들을 보충할수 있다 . 

QObject 의 파생클라스를 계승하는 다중계승을 수행할 때 늘 QObject 의 파생클라스를 먼저 
놓아서 moc 가 그것을 포착하도록 하여야 한다 . 

3 개의 읽고쓰기속성과 하나의 읽기전용속성을 선언한다 . Q_ENUMS() 마크로는 Speed 형이 
렬거형 이 라는것을 moc 에게 알리 는데 필요하다 . Speed 렬거 는 클라스의 공개부에서 선 언된다 . 
public: 

enum Speed { Slow, Normal, Fast }; 

AxBouncer(QWidget ^parent = 0, const char *name = 0); 
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void setSpeed(Speed newSpeed); 

Speed speed() const { return ballSpeed;} 
void setRadius(int newRadius); 
int radius() const { return ballRadius;} 
void setColor(const QColor &newColor); 

QColor color() const { return ballColor;} 

bool isRunning() const { return myTimerld != 0;} 

QSize sizeHint() const; 

QAxAggregated *createAggregate(); 
public slots: 
void start(); 
void stop(); 
signals: 

void bouncing(); 

AxBouncer 구성자는 parent 와 name 파라메 터를 가지는 창문부품의 표준구성자이다 . 
QAXFACTORY_DEFAULT(} 마크로는 부분품을 반출하는데 쓰이는데 구성자는 이 서명을 가진 
다 . 

createAggregate() 함수는 QAxBindable 로부터 재정의된다 . 그것을 보기로 하자 . 
protected: 

void paintEvent(QPaintEvent *event); 
void timerEvent(QTimerEvent *event); 
private: 

int intervalInMilliseconds() const; 

QColor ballColor; 

Speed ballSpeed; 
int ballRadius; 
int myTimerld; 
int x; 
int delta; 

}； 

클라스의 보호 및 비공개부는 표준 Qt 창문부품에서와 갈다 . 

AxBouncer: : AxBouncer(QWidget ^parent, const char *name) 

: QWidget(parent, name, WNoAutoErase) 

{ 


ballColor = blue; 




ballSpeed = Normal; 
ballRadius = 15; 
myTimerld = 0; 
x = 20; 
delta = 2; 

} 

AxBouncer 구성자는 클라스의 비공개 변수들을 초기화한다 . 
void AxBouncer: :setColor(const QColor &newColor) 

{ 

if (newColor != ballColor && requestPropertyChange("color M )) { 
ballColor = newColor; 
update(); 

propertyChangedC'color"); 

} 

} 

setColorQ 함수는 color 속성 의 값을 설 정한다 . 이 함수는 updateQ 를 호출하여 창문부품을 다 
시 그린다 . 

류다른 부분은 requestPropertyChange() 와 propertyChanged() 호출이 다 . 이 함수들은 
QAxBindable 을 계승하며 속성을 변경 할 때마다 실제로 호출되여야 한다 . 
requestPropertyChange() 는 의뢰기의 허가를 받아 속성을 변경하고 의뢰기가 변경을 허용하면 
true 를 돌려 준다 . propertyChangedO 함수는 의 뢰 기 에 속성 이 변 경 되 였 다는것 을 통지 한다 . 

setSpeed() 와 setRadius() 속성 설정함수들도 이 견본을 따르므로 start() 와 stop() 처리 부들을 실 
행한다 . 이로부터 이 함수들은 실행중에 속성값을 변경한다 . 

이제는 AxBouncer 성원함수를 보기로 하자 . 

QAxAggregated * AxBouncer: : createAggregate() 

{ 

return new Obj ectSafetylmpl; 

} 

createAggregate() 함수는 QAxBindable 로부터 재정의된다 . 이 함수는 QAxServer 모듈이 이미 
실현되지 않은 COM 대면부들을 실현하거나 分 tx&rver 의 기정 COM 대면부들을 넘기게 한다 . 여 
기서는 Internet Explorer 에서 부분품의 안전한 기능들을 호출하는데 쓰이는 IObjectSafety 대면부 
를 제공한다 . 이것은 Internet Explorer 의 “Object not safe for scripting” 오유통보문을 제거하는 
표준기술이다 . 

여기에 IObjectSafety 대면부를 실현하는 클라스의 정의가 있다 . 
class ObjectSafetylmpl : public QAxAggregated, public IObjectSafety 
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public: 

long queryInterface(const QUuid &iid, void **iface); 

QAXAGG_IUNKNOWN 

HRESULT WINAPI GetInterfaceSafetyOptions(REFIID riid, 

DWORD *pdwSupportedOptions, DWORD *pdwEnabledOptions); 

HRESULT WINAPI SetInterfaceSafetyOptions(REFIID riid, 

DWORD pdwSupportedOptions, DWORD pdwEnabledOptions); 

}； 

ObjectSafetylmpl 클라스는 QAxAggregated 와 IObjectSafety 를 모두 계승한다 . QAxAggregated 
클라스는 추가적인 COM 대면부들을 실현하기 위한 추상기초클라스이다 . QAxAggregated 가 전 
개하는 COM 객체는 controllingUnknownO 을 통하여 호출할수 있다 . 이 COM 객체는 QAxServer 
모듈에 의하여 배경에서 창조된다 . 

QAXAGG_IUNKNOWN 마크로는 Querylnterface(), AddRef(), Release() 의 표준실 현을 제 공한다 . 
이러한 실현은 단지 조종하고있는 COM 객체에 대하여 갈은 함수들을 호출한다 . 
long ObjectSafetylmpl::queryInterface(const QUuid &iid, void **iface) 

{ 

*iface = 0; 

if (iid == IID IObjectSafety) 

*iface = (IObjectSafety *)this; 
else 

return E_NOINTERFACE; 

AddRef(); 
return S_OK; 

} 

querylnterface() 함수는 QAxAggregated 의 순수가상함수이다 . 이 함수는 조종하고있는 COM 
객체에 의하여 호출되여 QAxAggregated 의 파생클라스가 제공하는 대면부의 호출을 준다 . 실 
현하지 않은 대면부와 IUnknown 에 대하여 E_NOINTERFACE 을 돌려주어 야 한다 . 

HRESULT WINAPI ObjectSafetyImpl::GetInterfaceSafetyOptions( REFIID riid, 

DWORD *pdwSupportedOptions, DWORD *pdwEnabledOptions) 

{ 

*pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA | 

INTERFACESAFE_FOR_UNTRUSTED_CALLER; 
*pdwEnabledOptions = *pdwSupportedOptions; 
return S_OK; 







HRESULT WINAPI ObjectSafetyImpl::SetInterfaceSafetyOptions(REFIID, DWORD, DWORD) 

{ return S_OK; } 

GetInterfaceSafetyOptions() 와 SetInterfaceSafetyOptions() 함수는 IObjectSafety 에 서 선언된다 . 
이 함수들은 객체가 대본에 적합하다는것을 알리기 위하여 실현한다 . 

그러면 main.cpp 를 고찰하자 . 

#include <qaxfactory.h> 

#include "axbouncer.h” 

QAXFACTORY_DEFAULT(AxBouncer ? 

,, {5e2461aa-a3e8-4f7a-8b04-307459a4c08c} M , 

"{SSSafllf^^Sde-SbTf^ddfSSSdlOlS}", 

M {772cl4a5-a840-4023-b79d-19549ece0cd9} M 5 

M {dbcele56-70dd-4f74-85e0-95c65d86254d} M , 

,, {3f3db5e0-78ff-4e35-8a5d-3d3b96c83e09} M ) 
int main() 

{ 

return 0; 

} 

QAXFACTORY_DEFAULT() 마크로는 ActiveX 조종요소를 반출한다 . 오직 하나의 조종요소 
만 반출하는 ActiveX 봉사기들에 이 마크로를 사용한다 . 그렇지 않으면 QAxFactory 의 파생클라 
스를 만들고 QAXFACTORY_EXPORT() 라는 마크로를 사용해야 한다 . 이 절의 다음 실례는 그 
수행방법을 보여준다 . 

QAXFACTORY_DEFAULT0 의 첫째 인수는 반출하려는 Qt 클라스의 이름이며 또한 조종요 
소가 반출되는 이름이다 . 그밖에 5 개 인수는 클라스 ID, 대면부 ID, 사건대면부 ID, 형서고 ID 그 
리고 응용프로그람 ID 이다 . guidgen 이 나 uuidgen 과 같은 표준도구를 사용하여 이 식 별자들을 생 
성 한다 . 

봉사기는 서고이므로 실제의 main() 함수를 요구하지 않는다 . 아직은 련결프로그람을 안정 
시키기 위해 가실현을 제공한다 . 

여기에 프로쎄스내 ActiveX 봉사기용의 .pro 파일이 있다 . 

TEMPLATE = lib 
CONFIG += activeqt dll 
HEADERS = axbouncer.h \ 
obj ectsafetyimpl.h 
SOURCES = axbouncer.cpp \ 
main.cpp \ 





obj ectsafetyimpl.cpp 
RCFILE = qaxserver.rc 
DEFFILE = qaxserver.def 

.pro 파일에서 참고한 qaxserver.rc 와 qaxserver.def 파일은 Qt 의 extensions\activeqt\control 등록부 
로부터 복사할수 있는 표준파일들이다 . 

makefile 혹은 qmake 가 생성한 Visual C++ 프로젝트파일은 Windows 등록자료기지에 봉사기 
를 등록하기 위한 규칙들을 포함한다 . 말단사용자콤퓨터들에 봉사기를 등록하기 위하여 모든 
Windows 체계들에서 regsvr32 도구를 리용할수 있다 . 

그다음 <object> 꼬리표를 리용하여 HTML 폐지 에 Bouncer 부분품을 포함할수 있다 . 

〈object id=’’AxBouncer" 

classid= M clsid:5e2461aa-a3e8-4f7a-8b04-307459a4c08c M > 

<b>The ActiveX control is not available. Make sure you have built and registered the 
component server.</b> 

</object> 

처리부들을 호출하는 단추들을 창조할수 있다 . 

<input type= n button" value= n Start" onClick= n AxBouncer.start() n > 

<input type= ,, button , ' value="Stop" onClick="AxBouncer.stop()"> 

그리고 다른 ActiveX 조종요소처 럼 JavaScript 나 VBScript 를 사용하여 창문부품을 조작할수 
있 다 . 

마지막 실례는 스크립트가능한 Address Book 응용프로그람이다 . 이 응용프로그람은 표준 
Qt/Windows 응용프로그람 혹은 프로쎄스외 ActiveX 봉사기로 작업할수 있다 . 두번째 경우의 가 
능성 은 가령 Visual Basic 를 사용하여 응용프로그람을 스크립 트하게 한다 . 
class AddressBook : public QMainWindow 

{ 

Q_OBJECT 

Q PROPERTY(int count READ count) 
public: 

AddressBook(QWidget ^parent = 0, const char *name = 0); 

〜 AddressBook(); 
int count() const; 
public slots: 

ABItem *createEntry(const QString &contact); 

ABItem *findEntry(const QString &contact) const; 

ABItem *entryAt(int index) const; 



AddressBook 창문부품은 응용프로그람의 기본창문이다 . 그것이 제공하는 속성과 처리 부들 
은 스크립링 에 사용할수 있다 . 

class ABItem : public QObject, public QListYiewItem 

{ 

Q_OBJECT 

Q_PROPERTY(QString contact READ contact WRITE setContact) 

Q_PROPERTY(QString address READ address WRITE setAddress) 

Q_PROPERTY(Q String phoneNumber READ phoneNumber WRITE setPhoneNumber) 
public: 

ABItem(QListView *listView); 

void setContact(const QString &contact); 

QString contact() const { return text (0); } 
void setAddress(const QString &address); 

QString address() const { return text(l); } 
void setPhoneNumber(const QString &number); 

QString phoneNumber() const { return text(2); } 
public slots: 

void remove(); 

}； 

ABItem 클라스는 주소록의 한개 항목을 표시 한다 . 이 것은 QListViewItem 을 계승하므로 
QListView 에 표시할수 있으며 QObject 를 계 승하므로 COM 객 체 로서 반출될 수 있다 . 
int main(int argc, char *argv[]) 

{ 

QApplication app(argc, argv); 
if (IQAxFactory :: isServer()) { 

AddressBook addressBook; 
app.setMainWidget(&addressBook); 
addressBook. show(); 
return app.exec(); 

} 

return app.execQ; 


main() 에서는 응용프로그람이 독립적으로 실행되고있는가 봉사기로 실행되고있는가를 검 
사한다 . activex 지 령 행선택은 봉사기로 실행하게 한다 . 응용프로그람이 봉사기로 실행되지 않으 




면 기 본창문부품을 창조하고 보통 독립 적 인 Qt 응용프로그람에 서 수행 한것 처 럼 그것 을 표시한 
다 . 

-activex 와 함께 ActiveX 봉사기 들은 다음과 같은 지 령 행추가선택들을 인식 한다 . 

•-regserver 는 체계 등록에 봉사기를 등록한다 . 

•-unregserver 는 체계 등록으로부터 봉사기 등록을 해제 한다 . 

•-dumpidpe 은 봉사기의 IDL 을 지정된 파일에 써넣는다 . 

응용프로그람을 봉사기로 실행하는 경우에 AddressBook 와 ABItem 클라스들을 COM 부분 
품들로 반출할 필요가 있다 . 즉 

QAXFACTORY_EXPORT(ABFactory, "{2b2b6f3e-86cf-4c49-9df5-80483b47fl7b}", 

" {8e827b25 - 148b-4307-ba7d-23f275244818}") 

QAXFACTORY_EXPORT() 마크로는 COM 객 체 들을 창조하기 위한 공장을 반출한다 . 두가지 
형의 COM 객체들을 반출하려고 하므로 이전의 실례에서와 같이 단순히 

QAXFACTORY_DEFAULT0 를 사용할수 없다 . 

QAXFACTORY_EXPORT() 의 첫째인수는 응용프로그람의 COM 객체들을 제공하는 

QAxFactory 클라스의 이름이 다 . 다른 2 개 인수는 형서 고 ID 와 응용프로그람 ID 이 다 . 
class ABFactory : public QAxFactory 

{ 

public: 

ABFactory(const QUuid &lib, const QUuid &app); 

QStringList featureList() const; 

QWidget *create(const QString &key, QWidget ^parent, const char *name); 

QUuid classID(const QString &key) const; 

QUuid interfaceID(const QString &key) const; 

QUuid eventsID(const QString &key) const; 

QString exposeToSuperClass(const QString &key) const; 

}； 

ABFactory 클라스는 QAxFactory 을 계승하며 AddressBook 클라스를 ActiveX 조종요소로 , 

ABItem 클라스를 COM 부분품으로 반출하기 위한 가상함수들을 재 정의한다 . 

ABFactory: : ABFactory(const QUuid &lib, const QUuid &app) : QAxFactory(lib, app) {} 
ABFactory 구성자는 단순히 기초클라스 구성자에 그의 2 개 파라메 터를 넘긴다 . 

QStringList ABFactory: : featureList() const 

{ 

return QStringList() « "AddressBook" « "ABItem"; 

} 

featureListO 함수는 공장이 제공하는 COM 부분품들의 목록을 돌려준다 . 



QWidget *ABFactory :: create(const QString &key, QWidget ^parent, const char *name) 

{ 

if (key == "AddressBook") 

return new AddressBook(parent, name); 
else 

return 0; 

} 

create() 함수는 ActiveX 조종요소의 실례를 창조한다 . 사용자들이 ABItem 객체들을 창조하기 
를 바라지 않으므로 ABItem 용의 null 지적자를 돌려준다 . 또한 create() 돌림값형은 QWidget * 이 
다 . 이것은 ActiveX 조종요소가 아닌 COM 객체를 돌려주는것을 방지한다 . 

QUuid ABFactory :: classID(const QString &key) const 

{ 

if (key == "AddressBook") 

return QUuid( M {588141ef-110d-4beb-95ab-ee6a478b576d } M )； 
else if (key — M ABItem") 

return QUuid(" {bc82730e-5D9-4e5c-96be-461c2cd0d282 } M )； 
else return QUuid(); 

} 

classIdO 함수는 공장에 의해 반출된 모든 클라스들의 클라스 ID 를 돌려준다 . 

QUuid ABFactory: : interfaceID(const QString &key) const 

{ 

if (key == "AddressBook") 

return QUuid(" {718780ec-b30c-4d88-83b3-79b3d9e78502} ")； 
else if (key = "ABItem") 

return QUuid( M {c8bc 1656-870e-48a9-9937-fbe 1 ceff8b2e}"); 
else 

return QUuid(); 

} 

interfaceID() 함수는 공장에 의해 반출된 클라스들의 대면부 ID 를 돌려준다 . 

QUuid ABFactory: : eventsID(const QString &key) const 

{ 

if (key == "AddressBook") 

return QUuid(" {0a06546f-9f02-4fl4-a269-d6d56ffeb861}"); 
else if (key = "ABItem") 

return QUuid(" {105c6b0a-3fc7-460b-ae59-746d9d4b 1724}"); 




else 

return QUuid(); 

} 

eventsld() 함수는 공장에 의해 반출된 클라스들의 사건 대 면부 ID 를 돌려 준다 . 

QString ABFactory: : exposeToSuperClass(const QString &key) const { return key; } 

기 정 으로 ActiveX 조종요소들은 자기 뿐아니 라 QWidget 까지 의 웃준위 클라스에 이 르기 까지 
의 속성，신호，처리부들을 의뢰기들에 공개한다 . exposeToSuperClassO 함수를 재정의하여 공개 
하려는 제 일 높은 준위의 기초클라스 ( 계승나무에서)를 돌려준다 . 

여기서는 부분품의 클라스이름 (AddressBook 혹은 ABItem) 을 반출하려는 제일 웃준위의 
기초클라스로서 돌려준다 . 이것은 AddressBook 와 ABItem 의 웃준위클라스들에서 정의된 속성， 
신호，처리부들이 반출되지 않는다는것을 의미한다 . 

다음은 프로쎄스외 ActiveX 봉사기의 .pro 파일이다 . 

CONFIG += activeqt 

HEADERS = abfactory.h \ 
abitem.h\ 
addressbook.h\ 
editdialog.h 

SOURCES = abfactory.cpp\ 
abitem.cpp\ 
addressbook.cpp\ 
editdialog.cpp\ 
main.cpp 

RCFILE = qaxserver.rc 

.pro 파일에서 참고한 qaxserver.rc 파일은 표준파일로서 (가의 extensions\activeqt\contr 이등록부 
에서 복사할수 있다 .. 

Address Book 봉사기 를 사용하는 Visual Basic 프로젝 트용의 vb 등록부의 실례 를 보시 오 . 

이로서 ActiveQt 틀거리를 개괄하였다 . Qt 배포물에는 추가적인 실례들과 QAxContainer 와 
QAxServer 모듈의 건설방법과 일반적인 호상운영문제를 해결하는 방법에 대한 정보들이 포함 
되여 있다 . 


제3절. 쎄숀관리 

XII 에서 로그아우트할 때 일부 창문관리기들은 쎄손을 보관하려고 하는가를 묻는다 . Yes 
라고 대답하면 실행중에 있던 응용프로그람들은 다음번에 로그인할 때 자동적으로 재기동하 
고 이전에 로그아우트할 때와 같은 상태 ( 화면위치)를 가전다 . 

쎄 손의 보관과 복귀 를 고려 하는 XII 에 고유한 부분품을 쎄 손관리기 (session manager) 라고 
부론다 . Qt 응용프로그람이 쎄손관리기를 인식하게 하기 위하여 QApplication::saveState()4 - 재정 
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의하고 거기에 응용프로그람의 상태를 보관한다. 


End session for dominie 

W Save 3e$sion for future logins 
Logout | Carcel 


그림 18-4.KDE 에서 로그아우트 

Windows 2000과 XP (그리 고 일 부 Unix 체 계 들)는 동면 이 라는 다른 기 구를 제 공한다. 사용자 
가 콤퓨터 를 동면상태 에 넣을 때 조작체계는 단순히 콤퓨터의 기 억기를 디스크에 출력하고 
기동시 에 그것을 재적재한다. 응용프로그람들은 아무것도 할 필요가 없고 지어는 이 런 일에 
대하여 알 필요가 없다. 

QApplication::commitData() 을 재정의하여 사용자가 체계완료 (shutdown) 를 시작할 때 체계완 
료직전에 조종을 엄을수 있다. 이것은 보관하지 않은 자료를 보관하고 필요하다면 사용자와 
교제할수 있게 한다. 이것은 XII와 Windows 에서 같은 방법으로 작업한다. 

쎄손을 인식하는 TicTacToe 응용프로그람의 코드를 통하여 쎄손관리를 고찰한다. 우선 
main() 함수를 고찰한다. 

int main(int arge, char *argv[]) 

{ 

Application app(argc, argv); 

TicTacToe tic(0, "tic"); 
app.setTicTacToe(&tic); 
tic.show(); 
return app.exec(); 

} 

Application 객체를 창조한다. Application 클라스는 QApplication 을 계승하며 coirnnitData() 와 s 
aveState() 를 둘다 재정의하여 쎄숀관리를 유지한다. 
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그림 18-5. TicTacToe 응용프로그람 




다음으로 TicTacToe 창문부품을 창조하고 Application 객 체 에 그것 을 알리 고 표시 한다 . 
TicTacToe 창문부품을 tic 라고 부론다 . 쎄 손관리기 가 창문들의 크기 와 위 치 들을 되 살리 기 를 바 
란다면 제 일 웃준위창문부품들에 유일 이 름을 주어 야 한다 . 

여기에 Application 클라스의 정의가 있다 . 
class Application : public QApplication 
{ 

Q_OBJECT 

public: 

Application(int &argc, char *argv[]); 
void setTicTacToe(TicTacToe *tic); 
void commitData(QSessionManager &sessionManager); 
void saveState(QSessionManager &sessionManager); 
private: 

TicTacToe *ticTacToe; 

}； 

Application 클라스는 TicTacToe 창문부품의 지적자를 비공개변수로서 보유한다 . 
void Application::saveState(QSessionManager &sessionManager) 

{ 

QString fileName = ticTacToe->saveState(); 

QStringList discardCommand; 

discardCommand « "rm" « fileName; 

sessionManager.setDiscardCommand(discardCommand); 

} 

Xll 에서 saveState() 함수는 쎄손관리기가 응용프로그람의 상태를 보관하려고 할 때 호출된 
다 . 이 함수는 다른 가동환경에서도 물론 사용할수 있지만 절대로 호출되지 않는다 . 
QSessionManager 파라메 터는 우리가 쎄손관리 기와 교제 하게 한다 . 

우선 파일에 TicTacToe 창문부품의 상태를 보관하겠는가를 묻는다 . 그다음 쎄손관리기의 
포기지 령을 설정 한다 . 포기지 령 (discard cranmand) 은 현재의 상태를 고려하여 보관된 지 령을 삭 
제하기 위하여 쎄손관리기가 실행해야 할 지령이다 . 이 실례에서는 그것을 
rm file 

로 설정한다 . 

여기서 file 은 쎄손용의 보관상태를 포함하는 파일이름이고 rm 은 파일들을 삭제하는 표준 
Unix 지 령 이 다 . 

또한 쎄 손관리 기 는 재 기 동지 령 을 가진 다 . 재 기 동지 령 (restart command) 은 응용프로그람을 
재기동할 때 쎄손관리기가 실행하여야 할 지령이다 . 기정으로 Qt 는 다음의 재기동지령을 제 
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공한다. 


appname -session id_key 

첫 부분인 appname 은 argv [이으로부터 끌어 낸다. id 부분은 쎄 손관리기 가 제 공하는 쎄 손正)로 
서 각이한 응용프로그람들과 갈은 응용프로그람의 각이한 실행 에서 유일하다는것을 담보한다. 
fey 부분은 상태가 보관된 시간을 유일하게 식별하기 위하여 추가된다. 여러가지 리유로 쎄손 
관리 기 는 같은 쎄 손동안에 saveState () 를 여 러 번 호출할수 있고 각이한 상태 를 구별해 야 한다. 

현존 쎄 손관리기 들의 제 한으로 인하여 응용프로그람이 정 확히 재 기 동하기 를 바란다면 응 
용프로그람의 등록부가 PATH 환경변수에 있는가 확인해 야 한다. 특히 자체의 TicTacToe 실례를 
요구한다면 가령 그것을 / usr/bin 에 설치하고 tictactoe 를 실행해야 한다. 

TicTacToe 를 비 롯한 단순한 응용프로그람들에 서 재 기 동지 령 의 추가지 령행 인 수로서 상태 를 
보관할수 있다. 례를 들면 

tictactoe -state OX - XO - X-O 

이것은 파일에 자료를 보관하고 파일을 삭제하기 위한 포기지령의 제공으로부터 벗어나 
게 한다. 

void Application : : commitData(QSessionManager & sessionManager ) 

{ 

if ( ticTacToe -> gameInProgress () && sessionManager . allowsInteraction ()) { 
int ret = QMessageBox : : waming ( ticTacToe , tr (" Tic - Tac - Toe ’’), 

tr("The game hasn't finished.\nDo you really want to quit ?"), 

QMessageBox: : Yes | QMessageBox : : Default , 

QMessageBox: : No | QMessageBox : : Escape ); 
if (ret = QMessageBox : : Yes ) 
sessionManager . release (); 
else ses sionManager . cancel (); 

} 

} 

commitDataO 함수는 사용자가 로그아우트할 때 호출된다. 이 함수를 재정의하여 통보창을 
펼치고 사용자에게 있을수 있는 자료손실에 대하여 경고한다. 기정실현은 제일 웃준위창문부 
품들을 모두 닫는다. 이것은 사용자가 제목띠에서 x 단추를 찰칵함으로써 창문들을 하나씩 닫 
을 때와 같은 결과가 생기게 한다. 3장에서 closeEvent () 를 재정의하여 이것을 포착하고 통보창 
을 펼치는 방법을 보았다. 

이 실례에서는 commitDataO 를 재정의하고 통보창을 펼치여 오락을 진행하며 쎄손관리기 
가 사용자와의 교제를 허용한다면 사용자에게 로그아우트를 확인할것을 요구한다. 사용자가 
를 찰칵하면 release () 를 호출하여 쎄손관리기에게 로그아우트를 계속하겠는가고 통보하고 
사용자가 No 를 찰칵하면 cancel () 을 호출하여 로그아우트를 취소한다. 
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그 림 1 8-6. "Do you really want to quit?" 


이제는 TicTacToe 클라스를 고찰하자 . 
class TicTacToe : public QWidget 
{ 

Q-OBJECT 

public: 

TicTacToe(QWidget *parent = 0, const char *name = 0); 
QSize sizeHint() const; 
bool gameInProgress() const; 

QString saveStateQ const; 



void paintEvent(QPaintEvent *event); 
void mousePressEvent(QMouseEvent *event); 



enum { Empty Cross = ’X’，Nought = 'O' }; 
void clearBoard(); 
void restoreState(); 

QString sessionFileName() const; 

QRect cellRect(int row, int col) const; 
int cellWidth() const { return width() / 3; } 
int cellHeight() const { return height() / 3; } 
char board[3][3];int tumNumber; 

}； 

TicTacToe 클라스는 QWidget 를 계승하며 sizeHint(), paintEvent(), mousePressEvent () 를 재정의 
한다 . 또한 Application 에서 사용한 gameInProgress () 와 saveState () 함수를 제공한다 . 

TicTacToe :: TicTacToe(QWidget ^parent, const char *name) : QWidget(parent, name) 


setCaption(tr( M Tic-Tac-Toe M )); 

clearBoardQ; 
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if (qApp->isSessionRestored()) 
restoreState(); 

} 

구성 자에 서 는 장기 판을 지 우며 응용프로그람이 -session 선 택 으로 호출되 였다면 비 공개 함 
수 restoreState () 를 호출하여 낡은 쎄숀을 재적재한다 . 
void TicTacToe::clearBoard() 

{ 

for (int row = 0; row < 3; ++row) { 
for (int col = 0; col < 3; ++col) { 
board[row][col] = Empty; 

} 

} 

tumNumber = 0; 

} 

clearBoard () 에서는 모든 세포들을 지우고 tumNumber 를 0 으로 설정 한다 . 

QString TicTacToe::saveState() const 

{ 

QFile file(sessionFileName()); 
if (file.open(IO WriteOnly)) { 

QTextStream out(&file); 
for (int row = 0;row < 3;++row) { 
for (int col = 0;col < 3;++col) { 
out « board[row] [col]; 

} 

} 

} 

return file.name(); 

} 

saveStateQ 에서는 장기판의 상태를 디스크에 써넣는다 . 형식은 간단하며 교차일 때 ’X ’，령 
일 때 ’0 ’，그리고 빈 세포일 때 이다 . 

QString TicTacToe::sessionFileName() const 


return QDir: : homeDirPath() + M /.tictactoe_ M + qApp->sessionId() 
+ qApp->sessionKey(); 



sessionFileNameO 비공개함수는 현재 쎄숀 ID 와 쎄숀열쇠용의 파일이름을 돌려준다 . 이 함수 
는 saveStateQ 와 restoreState () 에 모두 쓰인 다 . 파일 이 름은 쎄 숀 ID 와 쎄 손열쇠 로부터 골어낸다 . 
void TicTacToe: : restoreState() 

{ 

QFile file(sessionFileName()); 

if (file.open(IO ReadOnly)) { 

QTextStream in(&file); 
for (int row = 0; row < 3; ++row) { 
for (int col = 0; col < 3; ++col) { 
in » board[row][col]; 
if (board[row][col] != Empty) 

++tumNumber; 

} 

} 

} 

repaint(); 

} 

restoreState () 에서는 되살아나는 쎄손에 대응하는 파일을 적재하고 장기판을 그 정보로 채 
운다 . 장기판에서 '와 (7 들의 수로부터 tumNumber 의 값을 끌어낸다 . 

TicTacToe 구성자에서 QApplication::isSessionRestored () 이 true 를 돌려주면 restoreState () 를 호 
출한다 . 그러한 경 우에 sessionldO 와 sessionKeyO 는 응용프로그람의 상태 를 보관할 때 와 같은 
값을 돌려주므로 sessionFileNameO 은 그 쎄손의 파일이름을 돌려준다 . 

우리는 항상 로그인하고 로그아우트할 필요가 있으므로 쎄손관리의 시험과 오유수정은 
실패할수 있다 . 이것을 피하는 한가지 방법은 XII 에서 제공된 표준 xsm 편의프로그람을 사용하 
는것이다 . xsm 을 처음으로 기동할 때 쎄손관리기창문과 말단을 펼친다 . 말단으로부터 기동하 
는 응용프로그람은 일반적으로 체계 범 위의 쎄손관리 기 대신에 xsm 을 쎄손관리기 로 사용한다 . 
그다음 xsm 의 창문을 사용하여 쎄 손을 끝내 고 재 기 동하고 혹은 포기할수 있으며 응용프로그 
람이 제대로 동작하는가 확인할수 있다 . 
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